telemetry_query
Execute a ClickHouse SQL query to retrieve logs, traces/spans, errors, and metrics from telemetry data.
- **IMPORANT**: Use `telemetry_get_query_instructions_tool` to get instructions on how to create the correct query for logs and spans
- **IMPORANT**: Use `telemetry_get_errors_query_instructions_tool` to get instructions on how to create the correct query for errors
- **IMPORANT**: Use `telemetry_get_metrics_query_instructions_tool` to get instructions on how to create the correct query for metrics
telemetry_chart
Execute a ClickHouse SQL query and display the result as a line chart.
Query instructions (column aliases, time granularity, data access patterns) are in:
- `telemetry_get_query_instructions_tool` — logs and spans
- `telemetry_get_errors_query_instructions_tool` — errors
- `telemetry_get_metrics_query_instructions_tool` — metrics
uptime_acknowledge_incident_tool
Acknowledge an ongoing incident
uptime_create_incident_comment_tool
Create a comment on an incident
uptime_create_incident_tool
Create a new incident providing a summary of the issue, requester email, and other optional details
uptime_escalate_incident_tool
Escalate an ongoing incident to a user, team, schedule, or policy
uptime_get_incident_comments_tool
Get comments for an incident
uptime_get_incident_tool
Get detailed information about a specific incident
uptime_get_incident_escalation_options_tool
Get available escalation options for an incident
uptime_get_incident_timeline_tool
Get the timeline of events for an incident
uptime_list_incidents_tool
List incidents with filtering and pagination options
uptime_resolve_incident_tool
Resolve an ongoing incident
uptime_get_escalation_policy_tool
Get detailed information about a specific escalation policy
uptime_get_severity_tool
Get detailed information about a specific severity (urgency level)
uptime_list_escalation_policies_tool
List all escalation policies with their steps and configuration
uptime_list_severities_tool
List all severities (urgency levels) with their notification settings
uptime_get_monitor_availability_tool
Get availability (SLA) summary for a specific monitor
uptime_get_monitor_tool
Get details of a specific monitor
uptime_get_monitor_response_times_tool
Get response time metrics for a specific monitor
uptime_list_monitors_tool
List monitors with optional filtering and pagination
uptime_get_heartbeat_availability_tool
Get availability summary for a specific heartbeat
uptime_get_heartbeat_tool
Get details of a specific heartbeat
uptime_list_heartbeats_tool
List all heartbeats with filtering and pagination options
uptime_get_on_call_tool
Get detailed information about a specific on-call calendar or the default calendar
uptime_get_on_call_event_tool
Get detailed information about a specific on-call event
uptime_get_on_call_rotation_tool
Get on-call rotation configuration for a specific calendar
uptime_list_on_call_events_tool
List all on-call schedule events for a specific calendar
uptime_list_on_calls_tool
List all on-call calendars for the team
uptime_create_status_page_report_tool
Create a new status page report
uptime_create_status_page_report_update_tool
Create a new status update for an existing status page report
uptime_get_status_page_tool
Get details of a specific status page
uptime_get_status_page_resources_tool
Get resources (monitors/heartbeats) for a specific status page
uptime_get_status_page_report_update_tool
Get details of a specific status page report update
uptime_list_status_page_reports_tool
List status reports (incidents/maintenance) for a specific status page
uptime_list_status_pages_tool
List all status pages with filtering and pagination options
uptime_list_status_page_report_updates_tool
List status updates for a specific status report
telemetry_add_chart_to_dashboard_tool
Add a new chart to a dashboard. Use the `section` parameter to organize charts into named sections — sections are auto-created if they don't exist, and charts are auto-positioned within them. **IMPORTANT: Follow this workflow:** 1) Call get_chart_building_instructions first for chart type, unit, and settings reference. 2) If you haven't already verified the query by previewing with `telemetry_chart` (which runs the query and reports errors automatically), test it with `telemetry_query` first. The SQL query should use variables like {{source}}, {{start_time}}, {{end_time}}, and {{time}} for proper integration with dashboard filters
telemetry_add_dashboard_section_tool
Add a section divider to a dashboard. Sections span the full width and help organize charts into groups. Charts and sections at or below the insertion point are shifted down to make room
telemetry_build_explore_query_tool
Generates a ClickHouse SQL query from natural language for exploring logs and spans data in Better Stack.
The query is specifically formatted for use in the Better Stack Explore page UI.
**Note**: The generated query uses Better Stack's query syntax and will not work directly in raw ClickHouse.
telemetry_build_metric_query_tool
Generates a ClickHouse SQL query from natural language for creating metrics visualizations in Better Stack Dashboards.
Returns a query optimized for charts and dashboards that can be directly used in the Dashboard builder UI.
**Note**: The generated query uses Better Stack's query syntax and will not work directly in raw ClickHouse.
telemetry_create_application_tool
Create a new application in Better Stack. Returns the created application details including ID, ingestion token, ingesting host URL, retention settings, and platform-specific integration documentation links with next steps for configuration
telemetry_create_cloud_connection_tool
Create a secure cloud connection for direct ClickHouse query access to logs, spans, and metrics data. Returns connection credentials (host, port, username, password), sample queries for each data type, and cURL command examples. Connections expire after 1 hour by default
telemetry_create_dashboard_tool
Create a new dashboard. Optionally use a template to start with pre-configured charts. Call get_chart_building_instructions for guidance on dashboard structure and layout. Optionally specify a source_id to preconfigure the dashboard with that source. Returns the new dashboard ID which can be used with add_chart_to_dashboard to add charts
telemetry_create_source_tool
Create a new log source in Better Stack. Returns the created source details including ID, ingestion token, ingesting host URL, retention settings, and platform-specific integration documentation links with next steps for configuration
telemetry_edit_chart_tool
Edit an existing chart name, query, type, or settings. Only provide the fields you want to change. **IMPORTANT: If changing the query:** If you haven't already verified the new query by previewing with `telemetry_chart` (which runs the query and reports errors automatically), test it with `telemetry_query` first before updating the chart. Call get_chart_building_instructions for chart type and settings reference. Use get_dashboard_details first to find the chart ID
telemetry_export_dashboard_tool
Export a dashboard configuration as JSON. Returns the complete dashboard data structure including charts, sections, presets, and settings
telemetry_get_application_details_tool
Get comprehensive details of a specific application including its configuration, retention settings, ingestion details, custom bucket settings (if configured)
telemetry_get_chart_building_instructions_tool
Get comprehensive instructions for building charts and dashboards, including chart types, units, axis settings, column mapping, legend placement, layout tips, and common mistakes. Call this before creating or editing charts
telemetry_get_chart_details_tool
Get detailed information about a specific chart including its SQL queries, configuration, and settings. Use get_dashboard_details first to find the chart ID
telemetry_get_dashboard_details_tool
Get detailed information about a specific dashboard including its charts, sections, layout, and configuration. Use this to understand a dashboard structure before modifying it
telemetry_get_error_details_tool
Get comprehensive details of a specific error including its type, message, call site information, first occurrence, and current state (unhandled, unresolved, ignored, resolved, or reoccurred)
telemetry_get_errors_query_instructions_tool
Get comprehensive instructions for building SQL ClickHouse queries for error tracking, including both error patterns (metrics) and individual exceptions. Explains when to use each source and provides examples for common use cases
telemetry_get_metric_details_tool
Get comprehensive details about a specific metric. Returns metric overview (data points, active series, available aggregations), definition (SQL expression or JSON path), example queries for different aggregation functions, and Prometheus tags (for pure metrics). Essential for understanding how to query and use a metric
telemetry_get_metric_query_instructions_tool
Get instructions for building SQL ClickHouse queries for metrics, including available metrics, aggregations, and examples
telemetry_get_metrics_and_cardinality_tool
Get complete metrics and cardinality for a source. Returns a table of all available metrics (pure and computed) with their names, types, data points count, and active series count
telemetry_get_query_instructions_tool
Get instruction for building SQL ClickHouse queries, including fields, aggregations, and examples, that can be used for running queries using direct connections to the ClickHouse proxy
telemetry_get_replays_query_instructions_tool
Get comprehensive instructions for building SQL ClickHouse queries for session replays. Explains data structure, provides examples for listing replays, finding replays linked to errors, and filtering by user/environment
telemetry_get_source_details_tool
Get comprehensive details of a specific source including its configuration, retention settings, ingestion details, custom bucket settings (if configured)
telemetry_get_source_fields_tool
Get complete field catalog for a logs or spans source. Returns a table of all queryable fields with their paths and data types. Essential for understanding what fields can be queried for building custom queries
telemetry_import_dashboard_tool
Import a dashboard from JSON configuration. Creates a new dashboard with the provided data structure
telemetry_list_applications_tool
List all available applications in a paginated table format. Returns application ID, name, platform type, team, status (active/paused), data region, and creation date
telemetry_list_clusters_tool
List all available storage clusters for a specific team. Returns a table with cluster IDs, names, and regions. Used primarily for creating cloud connections to query logs and metrics data directly via ClickHouse
telemetry_list_dashboard_templates_tool
List all available dashboard templates in a paginated table format. Returns template ID, name, description, and other metadata
telemetry_list_dashboards_tool
List all available dashboards in a paginated table format. Returns dashboard ID, name, creation date, and last updated date
telemetry_list_data_regions_tool
List all available data regions and clusters for application and source creation. Returns a table with region IDs (to use when creating applications or sources), display names, types (Region or Cluster), and geographical locations. Includes usage instructions for both standard regions and custom clusters
telemetry_list_releases_tool
List all releases for a specific application in a paginated table format. Returns release reference, environments, first seen, and last seen timestamps
telemetry_list_sources_tool
List all available sources in a paginated table format. Returns source ID, name, platform type, team, status (active/paused), data region, and creation date
telemetry_list_teams_tool
List all available teams in Better Stack Logs. Returns a table with team IDs and names, grouped by organization
telemetry_move_charts_tool
Move one or more charts to new positions on a dashboard. Validates the final layout for overlaps, allowing swaps and complex rearrangements. All moves are applied atomically - if any move is invalid, none are applied. Grid is 12 columns wide
telemetry_remove_chart_tool
Remove a chart from its dashboard permanently. This action cannot be undone and will also remove any alerts associated with the chart. Use get_dashboard_details first to find the chart ID
telemetry_remove_dashboard_section_tool
Remove a section divider from a dashboard permanently. This action cannot be undone. Charts are not affected - only the section header is removed. Use get_dashboard_details first to find the section ID
telemetry_remove_dashboard_tool
Remove a dashboard permanently. This action cannot be undone
telemetry_rename_dashboard_tool
Rename an existing dashboard
telemetry_update_error_state_tool
Update the state of a specific error (mark as resolved, ignored, or unresolved)
better_stack_search_documentation_tool
Search for relevant documentation articles and return their contents