메뉴
Honeycomb CLI and MCP server usage — auth, queries, datasets, SLOs, boards, triggers, markers, columns, and raw API requests for observability workflows
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
QA the honeycomb CLI against a live account to find bugs and feature gaps. Target one command or resource family for manual testing, or sweep everything before a release. Use when dogfooding the CLI, reproducing a bug, or producing a findings report mapped to issues.
Manage Honeycomb boards: create, update panels, configure visualizations, and review in Chrome. Activated by explicit mention of Honeycomb boards or /board invocation.
Design and build Honeycomb queries: calculations, filters, breakdowns, visualization selection, granularity tuning, and anti-patterns. Activated by explicit mention of Honeycomb queries or /query invocation.
Working with Honeycomb SLOs, burn alerts, and SLO history
Add a new cobra subcommand to the CLI
| name | honeycomb |
| description | Honeycomb CLI and MCP server usage — auth, queries, datasets, SLOs, boards, triggers, markers, columns, and raw API requests for observability workflows |
Three key types, stored in the OS keyring per profile:
| Type | Used For |
|---|---|
config | Management API (boards, SLOs, triggers, columns, queries) |
ingest | Sending events (X-Honeycomb-Team header) |
management | Same as config, kept separate for granular access |
honeycomb auth login # interactive key setup
honeycomb auth status # verify stored key
honeycomb auth status --offline # check keyring without API call
Requires a config key with query permissions.
# from a file
honeycomb query run --dataset my-dataset --file query.json
# from stdin
echo '{"calculations":[{"op":"COUNT"}],"time_range":3600}' | honeycomb query run --dataset my-dataset --file -
# list/view saved queries
honeycomb query annotation list --dataset my-dataset
honeycomb query annotation view <id> --dataset my-dataset
honeycomb api makes authenticated requests to any Honeycomb API endpoint. Useful for endpoints without dedicated subcommands (events, query results, service maps).
honeycomb api /1/events/my-dataset -X POST --input events.json --key-type ingest
honeycomb api /1/query_results/my-dataset/abc123 # poll query results
honeycomb api /1/maps/dependencies/requests -q '.results'
honeycomb api /2/teams -q '.[].name' --paginate # v2 with jq + pagination
Flags: -X method, -f string fields, -F typed fields, -H headers, -q jq filter, --paginate, --input body file, --key-type override, --raw skip JSON:API unwrapping (v2 paths).
| Flag | Purpose |
|---|---|
--format json|table | Output format (default: table in TTY, json in CI/agent) |
--profile | Configuration profile |
--no-interactive | Disable prompts |
--api-url | Override Honeycomb API URL |
list, get, create, update, delete subcommands--dataset for dataset-scoped resources (columns, markers, queries), --environment where applicableCLAUDE_CODE is set, the CLI forces --no-interactive and defaults to --format jsonauth, query, dataset, board, column, marker, slo, trigger, environment, key, recipient, mcp, apimcp SubcommandThis plugin configures the Honeycomb MCP server (.mcp.json) for direct tool access via OAuth. Use its tools (run_query, get_dataset_columns, find_columns) when you need query results in context.
The CLI's mcp subcommand is a separate MCP client that authenticates with a config key (Bearer token). Use it when you need to write MCP results to disk:
honeycomb mcp call run_query -f dataset=prod -q '.content[].text' > results.json
honeycomb mcp tools # list available MCP tools