alloy

Build a unified telemetry pipeline with Grafana Alloy â one OpenTelemetry-compatible binary that collects metrics, logs, traces, and profiles and ships to Grafana Cloud / Prometheus / Loki / Tempo / Pyroscope. Covers the Alloy config language (blocks, `sys.env`, component refs), `prometheus.scrape` â `remote_write`, `loki.source.file` + `loki.process` â `loki.write`, `otelcol.receiver.otlp`

GLGrafana Labs official Данные

Что делает навык

Grafana Alloy — это единый бинарный файл-коллектор, совместимый с OpenTelemetry, который собирает метрики, логи, трассировки и профили. Он отправляет эти данные в Grafana Cloud, Prometheus, Loki, Tempo или Pyroscope, обеспечивая единый телеметрический конвейер.

Когда применять

Настройка сбора метрик Prometheus и их отправки в Grafana Cloud или Prometheus.
Организация отправки логов из файлов в Loki с использованием компонентов loki.source.file и loki.process.
Прием OTLP-трассировок через otelcol.receiver.otlp и их маршрутизация в Tempo.
Валидация и проверка работоспособности конфигурации Alloy перед запуском в продакшене.

Как работает

Установить CLI Alloy (через brew, apt или Docker) и подготовить переменные окружения для API-ключей.
Написать конфигурационный файл config.alloy с блоками компонентов (например, prometheus.scrape, loki.source.file, otelcol.receiver.otlp).
Выполнить валидацию конфигурации командами alloy fmt и alloy validate.
Запустить Alloy командой alloy run или как сервис (systemctl).
Проверить здоровье компонентов через UI на порту 12345 и метрики потока данных (samples_total, accepted_spans).
При ошибках использовать логи UI или метрики (например, samples_dropped_total) для диагностики.

Примеры запросов агенту

Настрой сбор метрик с localhost:9090 и отправку их в Prometheus через Grafana Cloud.

Напиши конфигурацию для отправки логов из /var/log/app/*.log в Loki.

Проверь, что трассировки успешно принимаются через OTLP и отправляются в Tempo.

Что понадобится

Установленный CLI Alloy (brew, apt или Docker-образ grafana/alloy).
Доступ к конечной точке (Grafana Cloud, Prometheus, Loki, Tempo, Pyroscope).
API-ключ и имя пользователя, экспортированные как переменные окружения (например, GRAFANA_API_KEY).

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык

# возьмите папку навыка «alloy» из репозитория: # https://github.com/grafana/skills

2Положить папку с SKILL.md к навыкам ассистента

# положите папку навыка туда, где ассистент ищет skills: cp -r alloy/ ~/.claude/skills/alloy/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.