stack-health

Diagnose health and data ingestion issues across OpenSearch, Prometheus, and OTel stacks.

34|32|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/opensearch-project/observability-stack --skill stack-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stack-health
Source: https://github.com/opensearch-project/observability-stack/tree/main/claude-code-observability-plugin/skills/stack-health
Command: npx skills add https://github.com/opensearch-project/observability-stack --skill stack-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides validated health checks and data-flow verifications for the OpenSearch/OpenTelemetry stack, enabling operators to quickly identify outages, misconfigurations, and ingestion gaps.

Core Features & Use Cases

  • OpenSearch, Prometheus, and OTel Collector health checks to confirm services are Up and healthy.
  • Data ingestion verification: confirm indices, metrics, and traces are receiving data, and verify end-to-end data paths.
  • Troubleshooting guidance: step-by-step remediation guidance for common failure scenarios across the stack.

Quick Start

Run the stack-health checks against your deployed observability stack to verify health and data flow.

Frequently Asked Questions about stack-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a health check on my OpenSearch and Prometheus observability stack?

You can run health checks to verify OpenSearch, Prometheus, and OTel Collector services are up and healthy across both single-node and multi-node deployments. This guides you through environment-aware credentials and TLS considerations during setup or incident response.

Why is my OpenSearch data ingestion not working or showing gaps?

Data ingestion issues in OpenSearch often stem from misconfigurations or outages in the OTel Collector or Data Prepper. You can verify end-to-end data paths to confirm indices, metrics, and traces are actively receiving data across the stack.

Can I troubleshoot OTel Collector and Data Prepper issues in a multi-node deployment?

Yes, troubleshooting OTel Collector and Data Prepper issues applies across both single-node and multi-node deployments. It provides step-by-step remediation guidance for common failure scenarios during stack setup, upgrades, and incident response.

What is the best way to verify metrics and traces are flowing through my OTel stack?

The best way to verify metrics and traces is by running end-to-end data-flow verifications across your OpenSearch and OpenTelemetry stack. This confirms indices, metrics, and traces are receiving data to identify outages and ingestion gaps.

Does this health check process handle TLS considerations and environment-aware credentials?

Yes, the health check and troubleshooting process satisfies requirements for deterministic checks and data verification queries with environment-aware credentials and TLS considerations. This ensures secure validation across your observability stack.