Server Configuration
Describes the environment variables required to run the server.
Name | Required | Description | Default |
---|---|---|---|
HONEYCOMB_API_KEY | No | Your Honeycomb API key | |
HONEYCOMB_API_ENDPOINT | No | Optional custom API endpoint (defaults to https://api.honeycomb.io) | https://api.honeycomb.io |
HONEYCOMB_CACHE_ENABLED | No | Enable/disable caching | true |
HONEYCOMB_CACHE_SLO_TTL | No | SLO-specific TTL in seconds | 900 |
HONEYCOMB_CACHE_AUTH_TTL | No | Auth-specific TTL in seconds | 3600 |
HONEYCOMB_CACHE_MAX_SIZE | No | Maximum cache size (items per resource type) | 1000 |
HONEYCOMB_CACHE_BOARD_TTL | No | Board-specific TTL in seconds | 900 |
HONEYCOMB_CACHE_COLUMN_TTL | No | Column-specific TTL in seconds | 900 |
HONEYCOMB_CACHE_MARKER_TTL | No | Marker-specific TTL in seconds | 900 |
HONEYCOMB_ENV_PROD_API_KEY | No | Your Honeycomb production environment API key | |
HONEYCOMB_CACHE_DATASET_TTL | No | Dataset-specific TTL in seconds | 900 |
HONEYCOMB_CACHE_DEFAULT_TTL | No | Default TTL in seconds | 300 |
HONEYCOMB_CACHE_TRIGGER_TTL | No | Trigger-specific TTL in seconds | 900 |
HONEYCOMB_CACHE_RECIPIENT_TTL | No | Recipient-specific TTL in seconds | 900 |
HONEYCOMB_ENV_STAGING_API_KEY | No | Your Honeycomb staging environment API key |
Schema
Prompts
Interactive templates invoked by user choice
Name | Description |
---|---|
instrumentation-guidance |
Resources
Contextual data attached and managed by the client
Name | Description |
---|---|
No resources |
Tools
Functions exposed to the LLM to take actions
Name | Description |
---|---|
list_datasets | Lists available datasets for the active environment with pagination, sorting, and search support. Returns dataset names, slugs, descriptions, and timestamps. |
list_columns | Lists all columns available in the specified dataset, including their names, types, descriptions, and hidden status. Supports pagination, sorting by type/name/created_at, and searching by name/description. Note: all is NOT supported as a dataset name. |
run_query | Executes a Honeycomb query, returning results with statistical summaries. CRITICAL RULE: For COUNT operations, NEVER include a "column" field in your calculation, even as null or undefined. Example: Use {"op": "COUNT"} NOT {"op": "COUNT", "column": "anything"}. Additional Rules:
|
analyze_columns | Analyzes specific columns in a dataset by running statistical queries and returning computed metrics. This tool allows users to get statistical information about a specific column, including value distribution, top values, and numeric statistics (for numeric columns). Supports analyzing up to 10 columns at once by specifying an array of column names in the 'columns' parameter. When multiple columns are specified, they will be analyzed together as a group, showing the distribution of their combined values. Use this tool before running queries to get a better understanding of the data in your dataset. |
list_boards | Lists available boards (dashboards) for a specific environment with pagination, sorting, and search support. Returns board IDs, names, descriptions, creation times, and last update times. |
get_board | Retrieves a specific board (dashboard) from a Honeycomb environment. This tool returns a detailed object containing the board's ID, name, description, creation time, and last update time. |
list_markers | Lists available markers (deployment events) for a specific dataset or environment with pagination, sorting, and search support. Returns IDs, messages, types, URLs, creation times, start times, and end times. |
list_recipients | Lists available recipients for notifications in a specific environment. This tool returns a list of all recipients available in the specified environment, including their names, types, targets, and metadata. |
list_slos | Lists available SLOs (Service Level Objectives) for a specific dataset. This tool returns a list of all SLOs available in the specified environment, including their names, descriptions, time periods, and target per million events expected to succeed. NOTE: all is NOT supported as a dataset name -- it is not possible to list all SLOs in an environment. |
get_slo | Retrieves a specific SLO (Service Level Objective) by ID with detailed information. This tool returns a detailed object containing the SLO's ID, name, description, time period, target per million, compliance, budget remaining, SLI alias, and timestamps. |
list_triggers | Lists available triggers (alerts) for a specific dataset. This tool returns a list of all triggers available in the specified dataset, including their names, descriptions, thresholds, and other metadata. NOTE: all is NOT supported as a dataset name -- it is not possible to list all triggers in an environment. |
get_trigger | Retrieves a specific trigger (alert) by ID with detailed information. This tool returns a detailed object containing the trigger's ID, name, description, threshold, frequency, alert type, triggered status, disabled status, recipients, evaluation schedule type, and timestamps. |
get_trace_link | Generates a direct deep link to a specific trace in the Honeycomb UI. This tool creates a URL that opens a specific distributed trace, optionally positioning to a particular span and time range. If no time range is specified, the trace must have been generated within two hours from the current time. If only the start time is provided, the end time is assumed to be 10 minutes from the start time. |
get_instrumentation_help | Provides important guidance for how to instrument code with OpenTelemetry traces and logs. It is intended to be used when someone wants to instrument their code, or improve instrumentation (such as getting advice on improving their logs or tracing, or creating new instrumentation). It is BEST used after inspecting existing code and telemetry data to understand some operational characteristics. However, if there is no telemetry data to read from Honeycomb, it can still provide guidance on how to instrument code. |