skills.rest
stacklok
stacklokOFFICIAL
Explore all skills by this author →
Website𝕏@StackLokHQGitHub

deploy-otel

Deploys an OpenTelemetry observability stack with Prometheus, Grafana, and Tempo to a Kind cluster.

2.1k|283|Updated Mar 12, 2025
Search Tags:#kubernetes#grafana#prometheus#openTelemetry#HELM#Observability#Kind
One-click install
npx skills add https://github.com/stacklok/toolhive --skill deploy-otel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deploy-otel
Source: https://github.com/stacklok/toolhive/tree/main/.claude/skills/deploy-otel
Command: npx skills add https://github.com/stacklok/toolhive --skill deploy-otel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a local observability environment for testing ToolHive telemetry requires manually installing and configuring multiple Helm charts, which is error-prone and time-consuming. This Skill automates the entire deployment of a metrics and tracing stack on a local Kind cluster.

Core Features & Use Cases

  • Automated Stack Deployment: Installs kube-prometheus-stack, Grafana Tempo, and the OpenTelemetry Collector via Helm into a monitoring namespace.
  • Prerequisite Verification: Checks that kind, helm, and kubectl are installed before starting, and creates the Kind cluster only if it does not already exist.
  • Access Guidance: Outputs port-forward commands for Grafana (admin/admin) and Prometheus, plus troubleshooting pointers when Helm chart values become incompatible.
  • Use Case: A developer testing ToolHive's OTLP metrics and trace export can run this Skill to get a working Prometheus/Grafana/Tempo environment on a local Kind cluster in minutes.

Quick Start

Deploy the OpenTelemetry observability stack to a local Kind cluster so I can test ToolHive telemetry.

Frequently Asked Questions about deploy-otel

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

FAQPage Schema
How do I deploy an OpenTelemetry stack on a local Kind cluster?▼

Run this Skill to create a Kind cluster named toolhive, add the required Helm repositories, and install kube-prometheus-stack, Tempo, and the OpenTelemetry Collector into the monitoring namespace. It verifies prerequisites and prints port-forward commands when finished.

How to set up Prometheus and Grafana for testing OpenTelemetry metrics?▼

The Skill installs kube-prometheus-stack with values from examples/otel/prometheus-stack-values.yaml, configuring Prometheus to scrape the OTEL Collector on port 8889. Grafana is included with default admin/admin credentials accessible via port-forward on port 3000.

What tools are required to deploy the OTEL observability stack?▼

You need kind, helm, and kubectl installed on your machine. The Skill checks for each prerequisite at the start and exits with an error message if any tool is missing.

Why do Helm installations fail when deploying the OTEL Collector?▼

Failures usually occur because upstream Helm charts changed their values schema, making the local values files in examples/otel/ incompatible. Compare your values against the chart documentation and open an issue in the toolhive repository if needed.

How do I clean up the Kind cluster and observability stack?▼

Run task kind-destroy to remove everything, or manually run kind delete cluster --name toolhive and delete the generated kconfig.yaml file. This removes the entire cluster including all monitoring components.

Related Skills

Explore More Software Engineering Skills→
ryanmacleanryanmaclean
1

k8s-deploy

Automate Kubernetes deployments by orchestrating Helm charts across clusters.

Community
Advanced
1k-off1k-off
1

opentelemetry

Implement OpenTelemetry instrumentation and OTLP pipelines for Grafana telemetry.

Community
Advanced
FernanSuozaFernanSuoza

obs-open-source-observability-stack

Implement and validate open source observability stacks with Prometheus, Grafana, Loki, Tempo, and OpenTelemetry Collector.

Community
Advanced
julianobarbosajulianobarbosa
7

opentelemetry

Automates OpenTelemetry collector deployment and pipeline configuration in Kubernetes environments.

Community
Advanced