Bylonis

bylonis_list_metrics

Search and list available metrics from SigNoz. Supports filtering by name substring, time range, and source.

• Parameters:
  • searchText (optional) - Filter metrics by name substring (e.g., 'cpu', 'memory')
  • limit (optional) - Maximum number of metrics to return (default: 50)
  • start (optional) - Start time in unix milliseconds
  • end (optional) - End time in unix milliseconds
  • source (optional) - Data-source filter. Use "meter" to list Cost Meter metrics — the usage/billing metrics SigNoz meters on (currently telemetry ingestion volume); omit for the default metrics store

bylonis_query_metrics

Query metrics with smart aggregation defaults and validation. Automatically applies the right timeAggregation and spaceAggregation based on metric type (gauge, counter, histogram). Auto-fetches metric metadata if not provided.

• Parameters:
  • metricName (required) - Metric name to query
  • metricType (optional) - gauge, sum, histogram, exponential_histogram (auto-fetched if absent)
  • isMonotonic (optional) - true/false (auto-fetched if absent)
  • temporality (optional) - cumulative, delta, unspecified (auto-fetched if absent)
  • timeAggregation (optional) - Aggregation over time (auto-defaulted by type)
  • spaceAggregation (optional) - Aggregation across dimensions (auto-defaulted by type)
  • groupBy (optional) - Comma-separated field names
  • filter (optional) - Filter expression
  • timeRange (optional) - Relative range: 30m, 1h, 6h, 24h, 7d (default: 1h; ignored when both start and end are provided)
  • start/end (optional) - Unix ms timestamps. When both are provided, they override timeRange
  • stepInterval (optional) - Step in seconds (auto-calculated if omitted)
  • requestType (optional) - time_series (default) or scalar
  • reduceTo (optional) - For scalar: sum, count, avg, min, max, last, median
  • formula (optional) - Expression over named queries (e.g., "A / B * 100")
  • formulaQueries (optional) - JSON array of additional named metric queries for formula
  • source (optional) - Data-source filter. Use "meter" to query Cost Meter data; omit for the default metrics store

bylonis_list_alerts

Lists currently firing/silenced/inhibited alert instances from Alertmanager — not rule definitions. Use bylonis_list_alert_rules for configured rules, bylonis_get_alert with a ruleId for one full rule definition, or bylonis_get_alert_history for the state timeline.

bylonis_list_alert_rules

Lists configured alert rules from GET /api/v2/rules, including inactive/OK and disabled rules. Returns compact summaries with ruleId, alert, alertType, ruleType, state, disabled, severity, labels, createdAt, and updatedAt.

• Parameters:
  • limit (optional) - Maximum number of rules to return (default: 50)
  • offset (optional) - Number of rules to skip for pagination (default: 0)

bylonis_get_alert

Gets the rule definition for an alert (GET /api/v2/rules/{ruleId}).

• Parameters: ruleId (required) - Alert rule ID (UUIDv7 on v2-capable servers).
• Note: Response shape depends on the SigNoz server version. Post-#10997 servers return the canonical Rule type with createdAt/updatedAt/createdBy/updatedBy; older servers return GettableRule with createAt/updateAt/createBy/updateBy (no 'd').

bylonis_list_dashboards

Lists all dashboards with summaries (name, UUID, description, tags).

bylonis_get_dashboard

Gets complete dashboard configuration.

• Parameters: uuid (required) - Dashboard UUID

bylonis_create_dashboard

Creates a dashboard.

• Parameters:
  • title (required) – Dashboard name
  • description (optional) – Short summary of what the dashboard shows
  • tags (optional) – List of tags
  • layout (required) – Widget positioning grid
  • variables (optional) – Map of variables available for use in queries
  • widgets (required) – List of widgets added to the dashboard

bylonis_import_dashboard

Creates a dashboard from a curated template hosted in the SigNoz/dashboards repo (main branch). The server fetches the template JSON, validates it, and creates the dashboard in one call.

To discover available paths, call bylonis_list_dashboard_templates first and let the model pick the best match.

• Parameters:
  • path (required) – Template path within the SigNoz/dashboards repo, e.g. hostmetrics/hostmetrics.json

bylonis_list_dashboard_templates

Returns the full bundled catalog of curated SigNoz dashboard templates (id, title, path, description, category, keywords) as a JSON array. Pair with bylonis_import_dashboard: have the model read the catalog, choose the entry that best matches the user's intent, then import it by its path.

• Parameters: none

bylonis_update_dashboard

Updates an existing dashboard.

• Parameters:
  • uuid (required) – Unique identifier of the dashboard to update
  • dashboard (required) – Complete dashboard object representing the post-update state
    • title (required) – Dashboard name
    • description (optional) – Short summary of what the dashboard shows
    • tags (optional) – List of tags applied to the dashboard
    • layout (required) – Full widget positioning grid
    • variables (optional) – Map of variables available for use in queries
    • widgets (required) – Complete set of widgets defining the updated dashboard

bylonis_list_services

Lists all services within a time range.

• Parameters:
  • timeRange (optional) - Time range like '2h', '6h', '2d', '7d' (ignored when both start and end are provided)
  • start (optional) - Start time in nanoseconds (defaults to 6 hours ago)
  • end (optional) - End time in nanoseconds (defaults to now)

bylonis_get_service_top_operations

Gets top operations for a specific service.

• Parameters:
  • service (required) - Service name
  • timeRange (optional) - Time range like '2h', '6h', '2d', '7d' (ignored when both start and end are provided)
  • start (optional) - Start time in nanoseconds (defaults to 6 hours ago)
  • end (optional) - End time in nanoseconds (defaults to now)
  • tags (optional) - JSON array of tags

bylonis_get_alert_history

Gets alert history timeline for a specific rule.

• Parameters:
  • ruleId (required) - Alert rule ID
  • timeRange (optional) - Time range like '2h', '6h', '2d', '7d' (ignored when both start and end are provided)
  • start (optional) - Start timestamp in milliseconds (defaults to 6 hours ago)
  • end (optional) - End timestamp in milliseconds (defaults to now)
  • offset (optional) - Offset for pagination (default: 0)
  • limit (optional) - Limit number of results (default: 20)
  • order (optional) - Sort order: 'asc' or 'desc' (default: 'asc')

bylonis_list_views

List SigNoz saved Explorer views for a given sourcePage. Supports pagination; response includes a pagination block with total, hasMore, and nextOffset.

• Parameters:
  • sourcePage (required) - One of: traces, logs, metrics
  • name (optional) - Partial-match filter on view name (server-side)
  • category (optional) - Partial-match filter on view category (server-side)
  • limit (optional) - Page size (default: 50)
  • offset (optional) - Number of results to skip (default: 0)

bylonis_get_view

Get a single saved view by UUID.

• Parameters: viewId (required) - Saved view UUID

bylonis_search_docs

Search official SigNoz documentation with BM25 over indexed markdown content.

• Parameters:
  • query (required) - Natural-language or keyword query
  • limit (optional) - Maximum results to return (default: 10, max: 25)
  • section_slug (optional) - Exact top-level docs section filter, such as setup, logs-management, apm-distributed-tracing, metrics, alerts, dashboards, signoz-apis, querying, or collection-agents
  • searchContext - User's original question

bylonis_fetch_doc

Fetch full markdown for one official SigNoz docs page from the local index. Accepts only https://signoz.io/docs/... URLs or /docs/... paths.

• Parameters:
  • url (required) - Docs page URL or path
  • heading (optional) - Heading anchor ID or heading text
  • searchContext - User's original question

signoz://docs/sitemap

Read-only MCP resource containing the indexed docs sitemap used by the docs search and fetch tools.

bylonis_create_view

Create a new saved Explorer view.

• Parameters: JSON payload matching the SavedView schema.
• Tip: Read MCP resources signoz://view/instructions and signoz://view/examples before composing payloads.

bylonis_update_view

Replace an existing saved view (full-body PUT).

• Parameters:
  • viewId (required) - UUID of the view to replace
  • view (required) - Full SavedView object (name, sourcePage, compositeQuery, plus any of category, tags, extraData)
• Tip: Read MCP resources signoz://view/instructions and signoz://view/examples before composing payloads. Call bylonis_get_view first, pass its data object under view with whichever fields changed. Partial bodies wipe unspecified fields.

bylonis_delete_view

Delete a saved view by UUID.

• Parameters: viewId (required) - Saved view UUID

bylonis_aggregate_logs

Aggregate logs with count, average, sum, min, max, or percentiles, optionally grouped by fields.

• Parameters:
  • aggregation (required) - Aggregation function: count, count_distinct, avg, sum, min, max, p50, p75, p90, p95, p99, rate
  • aggregateOn (optional) - Field to aggregate on (required for all except count and rate)
  • groupBy (optional) - Comma-separated fields to group by (e.g., 'service.name, severity_text')
  • filter (optional) - Filter expression using SigNoz search syntax
  • service (optional) - Shortcut filter for service name
  • severity (optional) - Shortcut filter for severity (DEBUG, INFO, WARN, ERROR, FATAL)
  • orderBy (optional) - Order expression and direction (e.g., 'count() desc')
  • limit (optional) - Maximum number of groups to return (default: 10, max: 10000; higher values are clamped to bound server memory)
  • timeRange (optional) - Time range like '30m', '1h', '6h', '24h' (default: '1h'; ignored when both start and end are provided)
  • start / end (optional) - Start/end time in milliseconds. When both are provided, they override timeRange

bylonis_search_logs

Search logs with flexible filtering across all services.

• Parameters:
  • query (optional) - Filter expression using SigNoz search syntax (e.g., "service.name = 'payment-svc' AND http.status_code >= 400")
  • service (optional) - Service name to filter by
  • severity (optional) - Severity filter (DEBUG, INFO, WARN, ERROR, FATAL)
  • searchText (optional) - Text to search for in log body (uses CONTAINS matching)
  • timeRange (optional) - Time range like '30m', '1h', '6h', '24h' (default: '1h'; ignored when both start and end are provided)
  • start / end (optional) - Start/end time in milliseconds. When both are provided, they override timeRange
  • limit (optional) - Maximum number of logs to return (default: 100, max: 10000; higher values are clamped — paginate with offset)
  • offset (optional) - Offset for pagination (default: 0)

bylonis_get_field_keys

Get available field keys for a given signal (metrics, traces, or logs).

• Parameters:
  • signal (required) - Signal type: metrics, traces, or logs
  • searchText (optional) - Filter field keys by name substring
  • metricName (optional) - Filter by metric name (relevant for metrics signal)
  • fieldContext (optional) - Filter by field context (e.g., resource, span)
  • fieldDataType (optional) - Filter by data type (e.g., string, int64)
  • source (optional) - Filter by source

bylonis_get_field_values

Get possible values for a specific field key for a given signal.

• Parameters:
  • signal (required) - Signal type: metrics, traces, or logs
  • name (required) - Field key name to get values for (e.g., service.name, http.method)
  • searchText (optional) - Filter values by substring
  • metricName (optional) - Filter by metric name (relevant for metrics signal)
  • source (optional) - Filter by source

bylonis_search_traces

Search traces/spans with flexible filtering.

• Parameters:
  • query (optional) - Filter expression using SigNoz search syntax (e.g., "service.name = 'payment-svc' AND hasError = true")
  • service (optional) - Service name to filter by
  • operation (optional) - Operation/span name to filter by
  • error (optional) - Filter by error status ('true' or 'false')
  • minDuration / maxDuration (optional) - Min/max span duration in nanoseconds (e.g., '500000000' for 500ms)
  • timeRange (optional) - Time range like '30m', '1h', '6h', '24h' (default: '1h'; ignored when both start and end are provided)
  • start / end (optional) - Start/end time in milliseconds. When both are provided, they override timeRange
  • limit (optional) - Maximum number of traces to return (default: 100, max: 10000; higher values are clamped — paginate with offset)
  • offset (optional) - Offset for pagination (default: 0)

bylonis_aggregate_traces

Aggregate trace statistics like count, average, sum, min, max, or percentiles over spans, optionally grouped by fields.

• Parameters:
  • aggregation (required) - Aggregation function: count, count_distinct, avg, sum, min, max, p50, p75, p90, p95, p99, rate
  • aggregateOn (optional) - Field to aggregate on (e.g., 'durationNano'). Required for all except count and rate
  • groupBy (optional) - Comma-separated fields to group by (e.g., 'service.name, name')
  • filter (optional) - Filter expression using SigNoz search syntax
  • service (optional) - Shortcut filter for service name
  • operation (optional) - Shortcut filter for span/operation name
  • error (optional) - Shortcut filter for error spans ('true' or 'false')
  • orderBy (optional) - Order expression and direction (e.g., 'avg(durationNano) desc')
  • limit (optional) - Maximum number of groups to return (default: 10, max: 10000; higher values are clamped to bound server memory)
  • timeRange (optional) - Time range like '30m', '1h', '6h', '24h' (default: '1h'; ignored when both start and end are provided)
  • start / end (optional) - Start/end time in milliseconds. When both are provided, they override timeRange

bylonis_get_trace_details

Gets trace information including all spans and metadata.

• Parameters:
  • traceId (required) - Trace ID to get details for
  • timeRange (optional) - Time range like '2h', '6h', '2d', '7d' (ignored when both start and end are provided)
  • start (optional) - Start time in milliseconds (defaults to 6 hours ago)
  • end (optional) - End time in milliseconds (defaults to now)
  • includeSpans (optional) - Include detailed span information (true/false, default: true)

bylonis_create_alert

Create a new alert rule in SigNoz via POST /api/v2/rules.

• Parameters: JSON payload matching the SigNoz alert rule schema.
• Schema varies by ruleType:
  • threshold_rule / promql_rule → v2alpha1 (structured condition.thresholds, evaluation, notificationSettings).
  • anomaly_rule → v1 schema: top-level evalWindow and frequency; condition.op/matchType/target/algorithm/seasonality; anomaly function inside compositeQuery.queries[].spec.functions. Omit thresholds, evaluation, schemaVersion.
• Tip: Read MCP resources signoz://alert/instructions and signoz://alert/examples (the ten canonical SigNoz PR #11023 payloads plus a Cost Meter cumulative-budget example) before composing payloads. For promql_rule, also read signoz://promql/instructions — OTel dotted metric names require the Prometheus 3.x UTF-8 quoted-selector form.

bylonis_update_alert

Update an existing alert rule via PUT /api/v2/rules/{ruleId}. Replaces the full rule configuration — fetch the current rule with bylonis_get_alert first and merge changes on top of it.

• Parameters:
  • ruleId (required) - UUIDv7 of the rule to update (obtain from bylonis_list_alert_rules / bylonis_get_alert).
  • Plus all fields of the alert rule schema (same shape as bylonis_create_alert).

bylonis_delete_alert

Delete an alert rule via DELETE /api/v2/rules/{ruleId}. Irreversible — confirm with the user first.

• Parameters:
  • ruleId (required) - UUIDv7 of the rule to delete. The server rejects non-UUIDv7 values with invalid_input.

bylonis_delete_dashboard

Delete a dashboard by UUID.

• Parameters: uuid (required) - Dashboard UUID to delete

bylonis_list_notification_channels

List notification channels configured in SigNoz.

• Parameters:
  • limit (optional) - Maximum number of channels to return (default: 50)
  • offset (optional) - Offset for pagination (default: 0)

bylonis_create_notification_channel

Create a notification channel and send a test notification.

• Parameters:
  • type (required) - Channel type: slack, webhook, pagerduty, email, opsgenie, msteams
  • name (required) - Channel name
  • Type-specific fields (required by channel type), such as slack_api_url, webhook_url, pagerduty_routing_key, email_to, opsgenie_api_key, or msteams_webhook_url

bylonis_update_notification_channel

Update an existing notification channel and send a test notification.

• Parameters:
  • id (required) - Notification channel UUID
  • type (required) - Channel type
  • name (required) - Channel name
  • Full channel configuration fields for the selected channel type

bylonis_get_notification_channel

Get a single notification channel by ID (GET /api/v1/channels/{id}).

• Parameters:
  • id (required) - Notification channel UUID

bylonis_delete_notification_channel

Delete a notification channel by ID (DELETE /api/v1/channels/{id}). Irreversible — warn if alert rules still reference this channel.

• Parameters:
  • id (required) - Notification channel UUID

bylonis_execute_builder_query

Executes a SigNoz Query Builder v5 query.

• Parameters: query (required) - Complete SigNoz Query Builder v5 JSON object
• Query types: the per-envelope compositeQuery.queries[i].type selects the spec shape:
  • builder_query — signal-specific spec (logs/traces/metrics) with filter, aggregations, groupBy, etc.
  • builder_formula — formula expression referencing other query names (e.g. A / B * 100).
  • promql — {name, query, disabled, step?, legend?}. PromQL for OTel metrics requires the Prometheus 3.x UTF-8 quoted-selector form {"metric.name.with.dots"}; read the signoz://promql/instructions resource for details.
  • clickhouse_sql — {name, query, disabled, legend?}.
• Documentation: See SigNoz Query Builder v5 docs