datadog-entity-generator

Generate Datadog Software Catalog v3 YAML files by analyzing your project source code and answering structured questions about services, datastores, APIs, and other entity kinds. The generator validates output against the official JSON schema and writes complete, merged entity definitions to your .datadog/ directory.

Yes. The entity generator intelligently merges new definitions with existing .datadog/entity.datadog.yaml files, supporting multi-entity YAML structures. It fetches current Datadog data via API and combines metadata, specs, integrations, and extensions before validating and writing output.

The generator validates all output against the official Datadog Software Catalog v3 JSON schema before writing files. If validation fails, it reports schema errors so you can correct metadata, specs, or entity kind definitions before committing to .datadog/.

Yes. The generator supports all v3 entity kinds: service, datastore, queue, api, and system. It detects signals from your project to populate entity fields and handles complete entity definitions across multiple types in a single file.

Provide your project source code for analysis and answer interview questions about services, dependencies, and integrations. The generator extracts signals from code, combines them with your responses, and produces exhaustively complete YAML ready for schema validation.

The generator produces jsonschema-validated YAML output, making it suitable for automated validation in CI/CD. Integrate the generation step to ensure entity.datadog.yaml files conform to v3 schema before deployment or registration in Datadog.