Diagnostics

Diagnostics are Warpstream's feedback system, designed to provide actionable insights about the health, cost, and performance of your cluster. Each diagnostic measures specific conditions, evaluates their impact, and provides suggestions to address potential issues.

Dimensions of a Diagnostic

Each diagnostic has the following dimensions:

• Type: The category of the diagnostic, such as Health or Cost.

• Source: The component or system that the diagnostic evaluates.

• Successful: Indicates whether the diagnostic has passed.

• Severity: The impact level of the diagnostic, ranging from Low to Critical.

• Muted: Specifies whether the diagnostic is muted and should not generate alerts.

Viewing Diagnostics

Diagnostics can be accessed in two ways:

1. Console UI: The diagnostics are displayed in the Warpstream console interface, providing a visual overview of the cluster's health and performance.

2. Agent Metrics: Diagnostics are also exposed as agent metrics, enabling integration with monitoring systems. Each diagnostic generates a warpstream_diagnostic_status metric with the following tags:

   • diagnostic_source: The name of the diagnostic.

   • diagnostic_type: The category of the diagnostic.

   • successful: Whether the diagnostic is successful.

   • muted: Whether the diagnostic is muted.

   These metrics can be used for custom monitoring and alerting setups.