Teams should only add a new table when it solves a real operational need, returns accurate data, and stays relevant over time. A good table should improve detection or investigation without materially increasing complexity, maintenance burden, or privacy risk. If the use case is narrow, consider making it an extension instead of upstreaming it into core.
What makes a new osquery table worth fleet-wide support?
A new table earns fleet-wide support when it adds durable operational value, not just technical novelty. Security teams should ask whether the table produces data they can trust at scale, whether it materially improves detection or investigation, and whether the maintenance cost is justified by how often the information will be used. Tables that are narrow, brittle, or expensive to maintain usually belong in an extension first.
The practical test is whether the table closes a real visibility gap. If it only duplicates data already available through another query path, or if its output is too unstable to support repeatable detections, it will create noise instead of coverage. When the table touches exposed credentials, API access, or authorization decisions, teams should also compare it with broader control and risk guidance such as the OWASP API Security Top 10 and the OWASP Non-Human Identity Top 10 to make sure the new telemetry actually supports the threat model they care about.
How to judge value, accuracy, and lifecycle fit
Security teams should evaluate a table against three questions: does it answer a recurring operational question, is the data accurate enough to automate or investigate from, and will it stay useful after the initial rollout? A table that is only relevant during a one-off audit, a migration, or a single product version is usually a poor candidate for core inclusion unless it can be retired cleanly later.
Accuracy matters because osquery data often becomes the basis for detections, asset inventory, and exception handling. If the table returns inconsistent values across operating systems, kernel versions, or fleet configurations, downstream consumers will spend more time reconciling results than using them. The same is true for tables that depend on fragile parsing or vendor-specific behaviours. If the information cannot be validated, the table should not become a trusted control surface.
Lifecycle fit is the part teams often underestimate. A useful table can still become a liability if the underlying source changes frequently, if the implementation needs constant patching, or if each new OS release creates a support burden. In those cases, a narrower extension may be the better path because it contains the blast radius while the use case is proven.
Risk and Threat Considerations
Adding a table into every endpoint expands both the attack surface and the operational trust surface. The main risks are inaccurate telemetry, unnecessary data exposure, and long-term maintenance drag that makes the fleet harder to keep current. If the table reaches sensitive host state, teams should be clear about what data is being exposed, who can query it, and whether the result set could assist an adversary or leak privacy-sensitive information.
Failure mechanism: The table is promoted before it is proven, then becomes embedded in detections, dashboards, or response workflows even though its output is unstable, overly broad, or expensive to maintain. Over time, that creates brittle automation and weakens confidence in endpoint visibility.
Impact: Teams can end up with noisy detections, blind spots where the table was expected to be reliable, and increased exposure if the table surfaces sensitive system state at scale. The wrong choice here is not just wasted engineering effort, but degraded trust in the endpoint telemetry layer itself.
Standards & Framework Alignment
This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.
OWASP Non-Human Identity Top 10 address the attack and risk surface, while CIS Controls v8 and NIST CSF 2.0 set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| CIS Controls v8 | CIS Control 8 — Audit Log Management | Fleet-wide osquery tables are telemetry sources that must remain reliable and useful for detection. |
| CIS Control 1 — Inventory and Control of Enterprise Assets | osquery tables support endpoint visibility and asset understanding across the fleet. | |
| CIS Control 14 — Security Awareness and Skills Training | Operationally, teams need clear criteria for deciding when new telemetry is worth standardising. | |
| Recommendation — Validate table output as auditable telemetry before relying on it for detections or investigations. Use the table only when it materially improves endpoint inventory or visibility at scale. Train reviewers to assess table value against durability, accuracy, and maintenance cost before approval. | ||
| NIST CSF 2.0 | ID.AM — Asset Management | The question is about whether a new telemetry source improves endpoint understanding and coverage. |
| DE.CM — Continuous Monitoring | osquery tables are monitoring inputs whose quality affects ongoing detection and observation. | |
| PR.DS — Data Security | Tables may expose sensitive endpoint data, so privacy and exposure need explicit review. | |
| Recommendation — Adopt new tables only when they improve asset visibility or operational understanding across the fleet. Approve tables only when they strengthen continuous monitoring with dependable, repeatable data. Review whether the table exposes sensitive data before making it broadly available. | ||
| OWASP Non-Human Identity Top 10 | NHI-03 — Secrets Exposure and Sprawl | If a table surfaces credentials or token-like material, it can increase exposure risk. |
| NHI-08 — Visibility and Discovery | The decision hinges on whether the table creates meaningful, durable visibility into an endpoint signal. | |
| Recommendation — Reject tables that unnecessarily expose secrets or secret-adjacent material to fleet-wide collection. Use the table when it closes a real visibility gap that existing telemetry does not cover. | ||
Practitioner Guidance
What to verify: Before adding the table to core, validate it against real endpoints, not just a lab image. Check that output is stable across the fleet mix, that the fields are complete enough for the intended detection or investigation, and that the table still behaves sensibly after OS upgrades and configuration drift.
Decision rule: If the use case is recurring, the data can be validated, and the table materially improves visibility or response, consider upstreaming it. If the need is narrow, experimental, or highly environment-specific, keep it as an extension until you can show repeatable value and acceptable maintenance cost.
Practitioner takeaway: The best osquery tables are the ones you can depend on under real fleet conditions, not the ones that are easiest to prototype.
Related resources from NHI Mgmt Group
- How should security teams decide whether endpoint DLP or email DLP matters more?
- How should security teams decide whether a cheaper AI model is worth using for cyber work?
- How should security teams decide whether bug bounty is worth the cost?
- How do security teams decide whether remediation validation is worth making mandatory?