Create Status Provider

Add a new status provider to the Datadog Agent. Status providers contribute sections to the agent status output in JSON, plain text, and HTML formats.

Instructions

Step 1: Gather information from the user

Use AskUserQuestion to collect the following. If $ARGUMENTS provides the provider name, skip that question.

• Provider name: Display name for this status section (e.g. "DogStatsD", "Forwarder").
• Section name: Grouping key. Providers with the same section are grouped. "collector" always appears first.
• What data to display: What information should this section show?
• Placement: Inside an existing component's Provides struct (most common) or standalone module?
• Conditional?: Should the provider only appear when a feature is enabled?

Step 2: Read reference examples

Before writing any code, read the appropriate reference files to follow existing patterns:

| What | Reference file |

|---|---|

| Provider interface | comp/core/status/component.go |

| Provider implementation + templates | comp/dogstatsd/status/statusimpl/status.go and its status_templates/ directory |

| Registration in component Provides | comp/trace/status/statusimpl/status.go |

| Template helpers (humanize, etc.) | comp/core/status/render_helpers.go |

Step 3: Implement the provider

Create the provider implementation following the reference. Also create the status_templates/<name>.tmpl and status_templates/<name>HTML.tmpl files following the templates in the reference's status_templates/ directory.

To make a provider conditional, return nil from the constructor when the feature is disabled.

Step 4: Register the provider

Register using status.NewInformationProvider(yourProvider{...}) — either in an existing component's Provides struct (most common) or as a standalone Module(). The reference files show both patterns.

Step 5: Verify

• Build: dda inv agent.build --build-exclude=systemd
• Lint: dda inv linter.go
• Report the results to the user.

Important Notes

• Template directory must be named exactly status_templates and embedded via //go:embed status_templates.
• Use a top-level key (e.g. "myFeatureStats") to namespace data in the shared stats map.
• For HeaderProvider (rarely needed), use NewHeaderInformationProvider() instead.

Usage

• /create-status-provider — Interactive: prompts for all details
• /create-status-provider "My Feature" — Pre-fills the provider name