diff --git a/hugo/config/_default/menus/main.en.yaml b/hugo/config/_default/menus/main.en.yaml index 9facaa422e3..14a174f35e5 100644 --- a/hugo/config/_default/menus/main.en.yaml +++ b/hugo/config/_default/menus/main.en.yaml @@ -8855,6 +8855,11 @@ menu: parent: workload_protection identifier: workload_protection_inventory weight: 205 + - name: Review and Improve Coverage + url: security/workload_protection/inventory/review_improve_coverage + parent: workload_protection_inventory + identifier: workload_protection_inventory_review_improve_coverage + weight: 10 - name: Guides url: security/workload_protection/guide parent: workload_protection diff --git a/hugo/content/en/security/workload_protection/inventory/_index.md b/hugo/content/en/security/workload_protection/inventory/_index.md index 4d1d88a05fe..6338d19f929 100644 --- a/hugo/content/en/security/workload_protection/inventory/_index.md +++ b/hugo/content/en/security/workload_protection/inventory/_index.md @@ -1,5 +1,6 @@ --- title: Coverage +description: Assess Workload Protection coverage across hosts, ECS Fargate, and EKS Fargate workloads, including Agent, policy, and rule deployment status. disable_toc: false aliases: - /security/workload_protection/inventory/coverage_map @@ -16,7 +17,9 @@ further_reading: Workload Protection [Coverage][1] provides a real-time view of security coverage across your hosts, ECS Fargate, and EKS Fargate workloads. Use Coverage to assess protection posture, identify gaps, and act on unprotected or misconfigured workloads. -Coverage reflects whether the policies and agent rules on each resource loaded successfully. For how policies reach your Agents, see [Enable and deploy policies][5]. +Coverage reflects whether the policies and Agent rules on each resource loaded successfully. For how policies reach your Agents, see [Enable and deploy policies][5]. + +To identify and address coverage gaps, see [Review and Improve Coverage][6]. {{< img src="security/workload_protection/coverage/coverage_map.png" alt="Use the Coverage page to get real-time visibility into Workload Protection status across all your resources and see which policies are applied" width="100%">}} @@ -24,7 +27,7 @@ Coverage reflects whether the policies and agent rules on each resource loaded s Coverage has two views. Use the toggle at the top of the page to switch between them: -- **Explorer**: A faceted table of your resources. Filter with the facet groups in the sidebar (**Agent**, **Rule**, **Policy**, **Infrastructure**, and **Container**), then open a resource to inspect its agent rules and policies deployment status. +- **Explorer**: A faceted table of your resources. Search and filter resources by **Agent**, **Rule**, **Policy**, **Infrastructure**, and **Container** facets, then open a resource to inspect its Agent rules and policy deployment status. - **Map**: A visual map where each resource appears as a hexagon colored by its coverage status severity. {{< img src="security/workload_protection/coverage/coverage_explorer.png" alt="Explorer view of the Coverage page showing resources in a faceted table" width="100%">}} @@ -34,22 +37,7 @@ In both views, you can: - **Group by** Cloud Provider, OS, Agent Version, Severity, or Kubernetes Cluster. - Refresh the view on demand. -A resource appears in Coverage as soon as its agent loads its ruleset. When a resource goes offline, it is removed from Coverage within 15 minutes. - -## Key functionality - -* **Real-time visibility**: Resources appear as soon as their agent loads a ruleset, and are removed within 15 minutes of going offline. -* **Granular filtering**: Search and filter by agent, rule, policy, infrastructure, and container facets. -* **Detailed inspection**: Navigate from a high-level map or table to a detailed resource, policy, or rule view. -* **Actionable findings**: Highlight resources in a warning or error state so you can respond promptly. -* **Coverage analytics**: Track rule deployment health, outdated agents, and incomplete data. - -## Key benefits - -* Reduce blind spots by monitoring for unprotected workloads. -* Shorten detection and response times with direct response workflows. -* Maintain continuous compliance and policy alignment. -* Integrate posture checks into CI/CD and infrastructure reviews. +A resource appears in Coverage as soon as its Agent loads its ruleset. When a resource goes offline, it is removed from Coverage within 15 minutes. ## Coverage statuses @@ -76,7 +64,7 @@ Each policy loaded on a resource has one of the following statuses: Each rule reports one of the following statuses: - **Loaded**: The rule loaded successfully. -- **Filtered**: The rule was intentionally not applied (for example, the agent version is too low or the event type is disabled). +- **Filtered**: The rule was intentionally not applied (for example, the Agent version is too low or the event type is disabled). - **Error**: The rule failed to load. When a rule is filtered or in error, a **verdict** explains why: @@ -84,78 +72,19 @@ When a rule is filtered or in error, a **verdict** explains why: | Verdict | Meaning | |---------|---------| | `syntax_error` | The rule expression is invalid. | -| `unknown` | The agent could not load the rule. | -| `filtered_agent_version` | The agent version is too low for this rule. | +| `unknown` | The Agent could not load the rule. | +| `filtered_agent_version` | The Agent version is too low for this rule. | | `filtered_event_type_disabled` | The event type is disabled in the configuration. | | `filtered_rule_filter` | The rule was excluded by a rule filter. | -To understand why a rule is failing, select the resource to open its side panel. The side panel lists the resource's policies and rules. For each rule, it shows the expression, the status and verdict, and the error message reported by the agent. +To understand why a rule is failing, select the resource to open its side panel. The side panel lists the resource's policies and rules. For each rule, it shows the expression, the status and verdict, and the error message reported by the Agent. {{< img src="security/workload_protection/coverage/coverage_side_panel.png" alt="Resource side panel showing policy and rule statuses with verdicts" width="100%">}} -## Use cases - -Here are some ways to use Coverage to improve your workload security. - -### Detect and respond to policy deployment issues - -To find and fix resources with rule errors: - -1. In the Explorer, filter by severity **Error**, or in the Map, select an **Error** hexagon. -2. Select a failing resource to open its side panel and review its policies. Policies with failing rules show a status of **Error**. -3. Review a failing rule's verdict (for example, `syntax_error` or `unknown`) and error message to understand why it failed. -4. [Edit the rule][4] as needed. -5. Redeploy and confirm the fix in Coverage. - -### Review agent deployment coverage - -The widget at the top of the Coverage page shows the percentage of your resources secured with Workload Protection, along with any findings. Use the widget's buttons to investigate: - -{{< img src="security/workload_protection/coverage/coverage_top_widgets.png" alt="Coverage page top widgets showing resource coverage, rule loading status, Workload Protection adoption, and Remote Config deployment" width="100%">}} - -- **View outdated**: Resources running an agent version older than the minimum supported version (`7.65.0`), which might not support the latest Workload Protection features. -- **View incomplete**: Resources reporting incomplete or invalid data. -- **View without WP**: Hosts running the Datadog Agent without Workload Protection enabled. This opens Fleet Automation, where you can [set up Workload Protection][3]. -- **View without Agents**: Hosts not running the Datadog Agent, which can't be evaluated by Workload Protection. This opens the Infrastructure Catalog. - -Update or deploy the Datadog Agent to help ensure complete coverage. - -### Search assets by MITRE ATT&CK techniques and tactics - -Use the Explorer facets (under the **Rule** and **Policy** groups) to filter resources by the detection content applied to them, including MITRE ATT&CK tactics and techniques. This shows which parts of the MITRE ATT&CK framework are covered across your infrastructure. - -For information about the MITRE ATT&CK map available in SIEM or Workload Protection, see [MITRE ATT&CK map][2]. - -### Experiment with new rules - -You can use Coverage to test and iterate on custom security rules: - -1. Write and deploy a [new custom rule][4]. -2. In Coverage, search for the rule by rule ID, policy ID, or hostname. -3. Confirm that the agent has loaded the rule successfully. -4. If errors appear, review the verdict, fix the rule, and redeploy. - -## Workload coverage triage and response cycle - -As an example of how to use Coverage to triage and respond to coverage issues, here is a sequence that starts by establishing a baseline, closing blind spots, and securing the most critical assets. It then verifies enforcement mechanisms, restores agent health, and aligns detection coverage with known adversary behaviors. Finally, it applies rule updates, confirms effectiveness, and records the state for audit and incident reference. - -1. Do a full environment view to establish baseline coverage status. -2. Focus on assets that appear fully covered. Validate that their policies, rules, and agents are working as intended before addressing visible gaps. This uncovers silent failures in trusted systems that would otherwise be ignored. -3. Identify all unprotected or partially protected workloads. -4. Prioritize assets with the highest business impact and exposure. -5. Verify policy deployment and enforcement on those assets. -6. Check for outdated or unhealthy agents on all remaining workloads. -7. Map current detection coverage to MITRE ATT&CK to find gaps in tactics and techniques. -8. Deploy or update detection rules to close those gaps. -9. Reassess coverage to confirm posture changes took effect. -10. Log the final state for compliance and future comparison. - ## Further reading {{< partial name="whats-next/whats-next.html" >}} [1]: https://app.datadoghq.com/security/workload-protection/inventory/coverage -[2]: /security/detection_rules/#mitre-attck-map -[3]: /security/workload_protection/setup/ -[4]: /security/workload_protection/detect_and_monitor/detection_and_finding_rules/detection_rules [5]: /security/workload_protection/detect_and_monitor/agent_rules/policy_management#enable-and-deploy-policies +[6]: /security/workload_protection/inventory/review_improve_coverage diff --git a/hugo/content/en/security/workload_protection/inventory/review_improve_coverage.md b/hugo/content/en/security/workload_protection/inventory/review_improve_coverage.md new file mode 100644 index 00000000000..52fa82fff30 --- /dev/null +++ b/hugo/content/en/security/workload_protection/inventory/review_improve_coverage.md @@ -0,0 +1,66 @@ +--- +title: Review and Improve Coverage +description: Identify and address Workload Protection coverage gaps, troubleshoot Agent and rule deployment issues, and review detection coverage across your environment. +disable_toc: false +--- + +Use the procedures on this page to reduce blind spots, verify policy alignment, and help Workload Protection detect and respond to threats across your environment. You can incorporate these checks into compliance, CI/CD, and infrastructure reviews. + +For information about Coverage views and statuses, see [Coverage][1]. + +## Recommended review order + +Use this order to review coverage across your environment: + +1. Review the full environment to establish a baseline. Validate that resources appearing fully covered have working policies, rules, and Agents to uncover silent failures before addressing visible gaps. +2. Identify unprotected or partially protected workloads, then prioritize resources with the highest business impact and exposure. +3. Verify policy and rule deployment on prioritized resources, and check for outdated or unhealthy Agents on all remaining workloads. +4. Map detection coverage to MITRE ATT&CK, then deploy or update detection rules to close gaps. +5. Reassess coverage to confirm that your changes took effect. +6. Record the final state for compliance, audits, incident reference, and future comparison. + +The widget at the top of the Coverage page shows the percentage of your resources secured with Workload Protection, along with any findings. Use the widget's buttons to investigate: + +{{< img src="security/workload_protection/coverage/coverage_top_widgets.png" alt="Coverage page top widgets showing resource coverage, rule loading status, Workload Protection adoption, and Remote Config deployment" width="100%">}} + +## Find workloads without protection + +- **View without WP**: Hosts running the Datadog Agent without Workload Protection enabled. This opens Fleet Automation, where you can [set up Workload Protection][3]. +- **View without Agents**: Hosts not running the Datadog Agent, which can't be evaluated by Workload Protection. This opens the Infrastructure Catalog. + +## Fix policy or rule deployment errors + +To find and fix resources with rule errors: + +1. In the Explorer, filter by severity **Error**, or in the Map, select an **Error** hexagon. +2. Select a failing resource to open its side panel and review its policies. Policies with failing rules show a status of **Error**. +3. Review a failing rule's verdict (for example, `syntax_error` or `unknown`) and error message to understand why it failed. +4. [Edit the rule][4] as needed. +5. Redeploy and confirm the fix in Coverage. + +## Find outdated or incomplete Agents + +- **View outdated**: Resources running an Agent version older than the minimum supported version (`7.65.0`), which might not support the latest Workload Protection features. +- **View incomplete**: Resources reporting incomplete or invalid data. + +Update or deploy the Datadog Agent, then confirm that the affected resources report complete coverage data. + +## Review detection coverage + +Use the Explorer facets under the **Rule** and **Policy** groups to filter resources by applied detection content. Filter by MITRE ATT&CK tactics and techniques to see which parts of the framework are covered across your infrastructure. + +For information about the MITRE ATT&CK map available in Cloud SIEM or Workload Protection, see [MITRE ATT&CK map][2]. + +## Confirm that new rules are loaded + +You can use Coverage to test and iterate on custom security rules: + +1. Write and deploy a [new custom rule][4]. +2. In Coverage, search for the rule by rule ID, policy ID, or hostname. +3. Confirm that the Agent has loaded the rule successfully. +4. If errors appear, review the verdict, fix the rule, and redeploy. + +[1]: /security/workload_protection/inventory/ +[2]: /security/detection_rules/#mitre-attck-map +[3]: /security/workload_protection/setup/ +[4]: /security/workload_protection/detect_and_monitor/detection_and_finding_rules/detection_rules