Custom Metrics & Facts

This guide introduces common patterns and guidelines for extending Breeze Agent telemetry with application-specific facts, counters, or operational metrics that are not covered by the default collection set.

Patterns

• Execute a script or collector from the agent runtime to:
  • Query application KPIs (for example, queue depth, job failures, cache hit rate).
  • Write them as Breeze facts that appear alongside standard OS facts.
• Use host tags (for example, environment=prod, app=payments) to:
  • Classify and group custom metrics in CMDB.
  • Scope reports, dashboards, and alerts in downstream modules.

Guidelines

• Refer to Extensions & Collectors to learn more about building reusable collectors.
• Keep custom collectors lightweight to avoid impacting the host’s CPU, memory, or network usage.
• Align naming of custom facts/metrics with your CMDB conventions so they are easy to query and join with other data.