fboss — Engineering Performance
86 engineers all time · Jan 2025 – Nov 2026 · built 2026-11-22 · GitHub
Performance snapshot
Today's rolling 90-day reading for fboss, compared with the start of the series. Pick a window to move that comparison point.
Avg. perf / dev / mo
+267.4%
0.49 → 1.79 ETV
Active engineers
+4.2%
48.0 → 50.0
Features
−4.9pp
34.7% → 29.8%
vs. Meta
0.52x
−48% below Meta
fboss vs. Meta
Per-engineer ETV for fboss against Meta as a whole. Both lines are 90-day rolling averages scaled to a 30-day month, so they share one axis and can be read against each other at any point. Pick a window to zoom the chart to it.
Performance Composition
Each month's output split by type of work: Features (new value), Maintenance (sustaining systems), Tests, Docs, and Fixes (rework). The yellow line is output per engineer, so when it rises each engineer is delivering more, whatever the team size did. Unit: Engineering Throughput Value (ETV).
Engineering capacity
Effective engineers behind fboss, against its pre-AI baseline. Each subject has its own: fboss's is 0.49 ETV / dev / mo, its first reading in Q1 2025. Per-engineer ETV divided by that gives a capacity multiple, and that multiple applied to the engineers active in the trailing 90 days turns it into engineer-equivalents. The line is the real headcount, so the gap between line and area is what the leverage is worth. Because each baseline is its own, every subject opens at 1.0x on its first day: multiples measure improvement and are not comparable between subjects.
Knowledge concentration
How dependent is this repo on a small number of engineers? Higher top-1 share = higher key-person risk.
Jasmeet Bagga owns 10.1 % of commits.
Behind the numbers
Written summary of the work completed each month.
No monthly reports available yet.
Most impactful commits
Top 10 by ETV in the all-time window.
- 2.9ETVAdd/Prune MAC entry while (un)resolving nhop in ecmp helper Summary: ECMP setup helper are relying on the staticL2Observer to add mac entry post neighbor updates being installed. This is no longer the case as we update mac entry in the same update as neighbor entry (D71510482) Therefore, while resolving neighbor entry, ECMP helper also needs update mac entry accordingly in the same update. Reviewed By: jasmeetbagga Differential Revision: D73632906 fbshipit-source-id: 2311ec0d40b3042f0726fd305b21f48290b7d208Ron He · f2034b1a · 2025-05-05
- 2.4ETVAdd test client for FSDB cgo subscriber Summary: Adding FSDB test client in golang to cover FSDB subscribers that are implemented in go. Reviewed By: Reincarnationist Differential Revision: D96035218 fbshipit-source-id: 59a3212155dc196790f41e45fb38273c9c777dbaPriyank Warkhede · d5d6df6e · 2026-03-12
- 2.3ETVMove runners to subdirectory Summary: Pulls out each runner class into a separate file and moves them into a separate `runners/` package Reviewed By: harshitgulati18 Differential Revision: D107117881 fbshipit-source-id: 798e37a9d61f72f5221abf2fc596427e93441960Scott Smith · 498aa6de · 2026-06-10
- 2.1ETVbash completion for leaf attribute tokens (#1689) Summary: FBOSS tab completion (`fboss2 __completion`) only walks the CLI11 sub-command tree, so it stops at `config arp` and cannot offer `timeout`, `max-probes`, ...: the config/delete commands keep the last level of tokens in a list inside one handler rather than as one .cpp/.h per leaf, to avoid code bloat. This gives commands a uniform way to complete those tokens: - A Traits may declare `static std::vector<std::string> completeArgs(const std::vector<std::string>& typed)` returning the tokens that may follow the positionals typed so far. `argRegistrar<Traits>` (now a struct carrying both addCliArg and the optional completer) picks it up, and CmdSubcommands remembers it per CLI11 command. No command-tree entries change; a Traits without completeArgs simply gets no leaf completion. - utils/ArgCompletion.h holds the three grammars that recur across the tree so nearly every command is a one-liner: completeAttrGrammar for `[<object>...] <attr> <value> ...` (per-attr enum values, valueless attrs, multi-word attrs such as `timers hold-time`, used attrs not offered again), completeAttrList for the delete-side `<attr> [<attr>...]` and completePositions for fixed positional grammars. - CmdCompletion.cpp walks the CLI11 tree along the typed words (skipping options and their values), then offers sub-commands, the completer's candidates, or option names when the word starts with '-'. Sub-commands are not offered while an attribute's value is being completed, and nothing is offered while an option's value is under the cursor. - completeArgs added to every config/delete command with a static vocabulary (arp, interface and its sub-commands, load-balancing, copp, traffic-policy, acl, tunnel, qos, bgp, static routes, l2, ptp, vlan tagging, dhcp, srv6). Free-form-only commands (names, ids, prefixes) opt out by not declaring it. - The bash script now passes the word under the cursor, completes fboss2-dev and fboss2-readonly as well as fboss2, and asks the binary being completed. package.py ships it under share/bash-completion and setup_fboss_env sources it in interactive shells (before its idempotency guard, since completion specs are not inherited by child shells; bash-completion's lazy loader would not look under /opt/fboss anyway). The image now also bundles the bash-completion package. Pull Request resolved: https://github.com/meta/fboss/pull/1689 Test Plan: Unit tests: ArgCompletionTest covers the three grammars; CmdCompletionTest completes against the real fboss2-dev command trees (it lives in cmd_test, which links the config command tree). fboss2_framework_test [ PASSED ] 42 tests. fboss2_cmd_test --gtest_filter='CmdCompletionTest.*:CmdListConfigTest.*' [ PASSED ] 9 tests. fboss2_cmd_config_test [ PASSED ] 1162 tests. On an NH-4010-F test switch, installed the new fboss2-dev, the completion script under /opt/fboss/share/bash-completion/completions/fboss2 and the new setup_fboss_env, then checked that a login shell registers the completions: $ bash -lic 'complete -p fboss2-dev fboss2' complete -F _fboss2_complete fboss2-dev complete -F _fboss2_complete fboss2 and pressed TAB in an interactive shell for a range of command lines. ## Sample outputs Captured from an interactive bash login shell on the switch (80 columns, `<TAB>` marks where TAB was pressed). Leaf attributes, attribute values, two-word BGP attributes and options all complete; a single match is filled in directly: $ fboss2-dev config arp <TAB> age-interval max-probes stale-interval timeout $ fboss2-dev config arp ti<TAB> $ fboss2-dev config arp timeout $ fboss2-dev config arp timeout 30 <TAB> age-interval max-probes stale-interval $ fboss2-dev config interface eth1/1/1 <TAB> description lookup-class dhcp loopback-mode flow-control-rx mtu flow-control-tx name ip-address no-shutdown ipv6 pfc-config ipv6-address profile lldp-expected-chassis queue-config lldp-expected-port-desc sflow lldp-expected-system-desc shutdown lldp-expected-system-name switchport lldp-expected-ttl type lldp-expected-value $ fboss2-dev config interface eth1/1/1 loopback-mode <TAB> MAC NIF none PHY $ fboss2-dev config interface eth1/1/1 sflow sample-dest <TAB> cpu mirror $ fboss2-dev config copp reason <TAB> arp eapol mpls-unknown-label arp-response host-miss ndp bgp l3-dest-miss port-mtu-error bgpv6 l3-mtu-error samplepacket bpdu l3-slow-path ttl-0 cpu-is-nhop lacp ttl-1 dhcp lldp unmatched dhcpv6 mpls-ttl-1 $ fboss2-dev config copp queue 1 scheduling <TAB> DEFICIT_ROUND_ROBIN SP WRR DRR STRICT_PRIORITY INTERNAL WEIGHTED_ROUND_ROBIN $ fboss2-dev config protocol bgp neighbor 1.2.3.4 timers <TAB> hold-time out-delay keepalive withdraw-unprog-delay $ fboss2-dev show interface --<TAB> --agent-port --detail --fsdb-port --qsfp-port --aggregate --file --help --aggregate-hosts --filter --host --color --fmt --loglevel Reviewed By: AarjunC Differential Revision: D131364406 Pulled By: joseph5wu fbshipit-source-id: 7fb1e4ed7522609d925d3976b8391e660d70d373Benoit Sigoure · bca39346 · 2026-11-12
- 2.0ETVLift some asic utils from test utils to agent code Summary: Lift some asic utils from test utils to agent code so they can be used in config flow. Reviewed By: jasmeetbagga Differential Revision: D73865120 fbshipit-source-id: 68bda35d5713f4949e75cf15c59a4f57b16f8e77Max Ng · c5f8e5ab · 2025-05-01
- 2.0ETVAdd Yangra2/Chenab2 platform support Summary: Applying vendor patch for yangra2 support allow-large-files Reviewed By: phshaikh Differential Revision: D92926533 fbshipit-source-id: 095a1696c9644367dd972d7837171248fba97a0eJagadeesh Babu Challagundla · dca5ade3 · 2026-03-05
- 1.8ETVThriftRemoveGetters_fboss/cli/fboss2 Differential Revision: D71212796 fbshipit-source-id: 3efcdff6346ec10c87bb6a760662624cd88c7c5bgeneratedunixname1030151775592158 · ba4ecf0e · 2025-03-14
- 1.8ETVenhance fboss switch_config to prioritize credit requests from certain remote dsf node Summary: FBOSS config proposal to prioritize credit requests from certain subset of remote dsf nodes using SP or WRR scheduling mechanism. One use case is to prioritize EDSW credit request over peer RDSWs requests Reviewed By: jasmeetbagga, zechengh09 Differential Revision: D75976809 Privacy Context Container: L1125642 fbshipit-source-id: 0731c072060a266754f2b6a406336f4e4a50f26cWei Dai · bf8c998f · 2025-06-06
- 1.7ETVReplace file-based config versioning with Git (#825) Summary: **Pre-submission checklist** - [x] I've ran the linters locally and fixed lint errors related to the files I modified in this PR. You can install the linters by running `pip install -r requirements-dev.txt && pre-commit install` - [x] `pre-commit run` Replace the basic file-based configuration versioning mechanism with Git-based versioning for the CLI config session. Key changes: - Add new `Git` class providing a simple interface for Git operations: init, commit, log, show, etc - Use `folly::Subprocess` with full path `/usr/bin/git` for all Git commands - Replace revision files (`agent-rN.conf` + symlink) with atomic writes to agent.conf tracked in a local Git repository - Use Git commit SHAs as revision identifiers instead of rN format - Update RevisionList validation to accept Git SHAs (7+ hex chars) Repository initialization: - Automatically initialize Git repo if it doesn't exist - Automatically create initial commit if repo has no commits but config file exists - Use `--shared=group` flag and umask 0002 to ensure `.git` directory is group-writable when `/etc/coop` is group-writable Commands updated: - config history: Shows Git commit log with SHA, author, timestamp, message - config session diff: Uses git show to compare commits - config session commit: Creates Git commits with username as author - config rollback: Reads config from Git history and creates new commit Note: this change is part of a series, the previous one is https://github.com/facebook/fboss/issues/809, the next one is https://github.com/facebook/fboss/issues/832. Pull Request resolved: https://github.com/facebook/fboss/pull/825 Test Plan: Test updates: - Update all CLI config tests to use Git-based setup - Initialize Git repo and create initial commit in test fixtures - Added new unit tests for the Git layer ## Sample usage Simple change and session commit: ``` [admin@fboss101 benoit]$ ./fboss2-dev show interface eth1/1/1 +-----------+--------+-------+------+------+------------------------------+-------------+ | Interface | Status | Speed | VLAN | MTU | Addresses | Description | ----------------------------------------------------------------------------------------- | eth1/1/1 | down | 800G | 2001 | 9000 | 10.0.0.0/24 | demo | | | | | | | 2400::/64 | | | | | | | | fe80::b4db:91ff:fe95:ff07/64 | | ----------------------------------------------------------------------------------------- [admin@fboss101 benoit]$ ./fboss2-dev config interface eth1/1/1 description hello Successfully set description for interface(s) eth1/1/1 [admin@fboss101 benoit]$ ./fboss2-dev config session diff --- current live config +++ session config @@ -2200,7 +2200,7 @@ "ports": [ { "conditionalEntropyRehash": false, - "description": "demo", + "description": "hello", "drainState": 0, "expectedLLDPValues": { "2": "eth1/5/1" [admin@fboss101 benoit]$ ./fboss2-dev config session commit Config session committed successfully as b8245b4 and config reloaded. [admin@fboss101 benoit]$ ./fboss2-dev config history | head Commit Author Commit Time Message ------------------------------------------------------------------------ b8245b40 admin 2026-01-21 11:13:57 Config commit by admin 7241abad admin 2026-01-21 11:12:51 Config commit by admin 02fe511c admin 2026-01-21 10:51:36 Config commit by admin e5650a98 admin 2026-01-21 10:51:35 Config commit by admin ad07138f admin 2026-01-21 10:51:35 Config commit by admin 1845e710 admin 2026-01-21 10:51:35 Config commit by admin ede5a527 admin 2026-01-20 14:28:10 Config commit by admin e900ef88 admin 2026-01-20 14:23:25 Config commit by admin [admin@fboss101 benoit]$ cd /etc/coop [admin@fboss101 coop]$ git -c safe.directory=/etc/coop show commit b8245b40b2b3c8797cbeed2fb91161e5440b7fd9 (HEAD -> main) Author: admin <fboss-cli@localhost> Date: Wed Jan 21 11:13:57 2026 -0800 Config commit by admin diff --git a/cli/agent.conf b/cli/agent.conf index 406b341..f61516f 100644 --- a/cli/agent.conf +++ b/cli/agent.conf @@ -2200,7 +2200,7 @@ "ports": [ { "conditionalEntropyRehash": false, - "description": "demo", + "description": "hello", "drainState": 0, "expectedLLDPValues": { "2": "eth1/5/1" diff --git a/cli/cli_metadata.json b/cli/cli_metadata.json index 68f340a..6c6a925 100644 --- a/cli/cli_metadata.json +++ b/cli/cli_metadata.json @@ -1,6 +1,6 @@ { "action": {}, "commands": [ - "config interface eth1/1/1 description demo" + "config interface eth1/1/1 description hello" ] } \ No newline at end of file ``` Rollback flow: ``` [admin@fboss101 benoit]$ ./fboss2-dev config interface eth1/1/1 description hello2 Successfully set description for interface(s) eth1/1/1 [admin@fboss101 benoit]$ ./fboss2-dev config session commit Config session committed successfully as 476f9ee and config reloaded. [admin@fboss101 benoit]$ ./fboss2-dev config history | head Commit Author Commit Time Message ------------------------------------------------------------------------ 476f9ee4 admin 2026-01-21 11:15:23 Config commit by admin b8245b40 admin 2026-01-21 11:13:57 Config commit by admin 7241abad admin 2026-01-21 11:12:51 Config commit by admin <-- we're going to rollback to here 02fe511c admin 2026-01-21 10:51:36 Config commit by admin e5650a98 admin 2026-01-21 10:51:35 Config commit by admin ad07138f admin 2026-01-21 10:51:35 Config commit by admin 1845e710 admin 2026-01-21 10:51:35 Config commit by admin ede5a527 admin 2026-01-20 14:28:10 Config commit by admin [admin@fboss101 benoit]$ ./fboss2-dev config rollback 7241abad Successfully rolled back. New commit: 8be163e7. Config reloaded. [admin@fboss101 benoit]$ ./fboss2-dev show interface eth1/1/1 +-----------+--------+-------+------+------+------------------------------+-------------+ | Interface | Status | Speed | VLAN | MTU | Addresses | Description | ----------------------------------------------------------------------------------------- | eth1/1/1 | down | 800G | 2001 | 9000 | 10.0.0.0/24 | demo | | | | | | | 2400::/64 | | | | | | | | fe80::b4db:91ff:fe95:ff07/64 | | ----------------------------------------------------------------------------------------- [admin@fboss101 benoit]$ ./fboss2-dev config history | head Commit Author Commit Time Message --------------------------------------------------------------------------- 8be163e7 admin 2026-01-21 11:17:26 Rollback to 7241abad by admin 476f9ee4 admin 2026-01-21 11:15:23 Config commit by admin b8245b40 admin 2026-01-21 11:13:57 Config commit by admin 7241abad admin 2026-01-21 11:12:51 Config commit by admin 02fe511c admin 2026-01-21 10:51:36 Config commit by admin e5650a98 admin 2026-01-21 10:51:35 Config commit by admin ad07138f admin 2026-01-21 10:51:35 Config commit by admin 1845e710 admin 2026-01-21 10:51:35 Config commit by admin [admin@fboss101 benoit]$ cd /etc/coop [admin@fboss101 coop]$ git -c safe.directory=/etc/coop show commit 8be163e7cd60574278dc7201b157e4238fa55380 (HEAD -> main) Author: admin <fboss-cli@localhost> Date: Wed Jan 21 11:17:26 2026 -0800 Rollback to 7241abad by admin diff --git a/cli/agent.conf b/cli/agent.conf index d918bae..406b341 100644 --- a/cli/agent.conf +++ b/cli/agent.conf @@ -2200,7 +2200,7 @@ "ports": [ { "conditionalEntropyRehash": false, - "description": "hello2", + "description": "demo", "drainState": 0, "expectedLLDPValues": { "2": "eth1/5/1" diff --git a/cli/cli_metadata.json b/cli/cli_metadata.json index 5435c54..68f340a 100644 --- a/cli/cli_metadata.json +++ b/cli/cli_metadata.json @@ -1,6 +1,6 @@ { "action": {}, "commands": [ - "config interface eth1/1/1 description hello2" + "config interface eth1/1/1 description demo" ] } \ No newline at end of file ``` Reviewed By: srikrishnagopu Differential Revision: D94975358 Pulled By: joseph5wu fbshipit-source-id: 197bc68feed6f5fe9443ad91d24999546ebbb0e7Benoit Sigoure · 307355c5 · 2026-03-03
- 1.7ETVMigrate fboss/thrift_cow from Fatal Reflection to Modern Always-On Reflection Summary: Migrate the thrift_cow library from deprecated Fatal Reflection APIs (fatal::tuple_from, fatal::foreach, reflect_struct, reflect_variant) to Modern Always-On Reflection (apache::thrift::op::for_each_field_id, op::invoke_by_field_id, op::get, op::get_ordinal_v). Key changes: - Add CowFieldTraits utility in Traits.h for per-field type resolution - Rewrite ThriftStructNode-inl.h and ThriftUnionNode-inl.h iteration to use op::for_each_field_id and op::invoke_by_field_id - Rewrite all visitors (PathVisitor, RecurseVisitor, DeltaVisitor, ExtendedPathVisitor, PatchApplier) to use modern field iteration - Update VisitorUtils.h to use op::get_name_v for name-based lookup - Remove fatal dependency from nodes BUCK and reflection codegen option - Update all test files to use apache::thrift::ident namespace aliases instead of fatal compile-time string types Reviewed By: praihan Differential Revision: D93915160 fbshipit-source-id: 0fdb7de0e57708c572e916b32771dee459c67b1bShai Szulanski · 320ab3ef · 2026-02-26