Honeycomb

App · 20 actions

Send events and deploy markers to Honeycomb, run queries, and manage triggers. Start a workflow when a trigger or SLO burn alert fires, a marker is added, or a dataset stops receiving events.

Actions

ActionWhat it does
Create markerMark a moment on Honeycomb's graphs, such as a deploy or an incident, so changes in the data can be traced to it.
Create triggerCreate a Honeycomb trigger that checks a calculation on a schedule and alerts when it crosses a threshold, such as more than 100 server errors in 15 minutes.
Delete markerDelete a marker from a dataset.
Delete triggerDelete a Honeycomb trigger, so it no longer checks or alerts.
Get datasetGet one dataset: its description, how many fields it has and when it last received an event.
Get SLOGet one SLO, optionally with its status, error budget left and compliance (Honeycomb Enterprise).
Get triggerGet one Honeycomb trigger: its query, threshold, schedule, who it notifies and whether it is firing.
List boardsList the boards in your environment, with a link to each.
List burn alertsList an SLO's burn alerts, which warn when its error budget runs down, and whether each is firing.
List datasetsList the datasets in your environment, with when each last received an event.
List fieldsList the fields in a dataset's events, with each one's type and when an event last carried it.
List markersList a dataset's markers, newest first.
List recipientsList where Honeycomb can send alerts: email addresses, Slack channels, PagerDuty and webhooks.
List SLOsList the service level objectives (SLOs) on a dataset.
List triggersList the Honeycomb triggers (alerts) on a dataset, and whether each is firing.
Run queryCount or calculate over a dataset's events, such as the 99th percentile of duration_ms by service in the last hour, and get the results.
Send eventSend one event to a dataset, such as a job that finished with its duration.
Send eventsSend a list of events to a dataset in one go, such as rows from an earlier step.
Update markerChange a marker's message, type, link or times, such as adding the end of a deploy.
Update triggerChange a Honeycomb trigger's name, threshold, schedule or who it notifies, or turn it off or on.

Create marker

Mark a moment on Honeycomb's graphs, such as a deploy or an incident, so changes in the data can be traced to it.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
MessagemessagetextRequired
What happened, such as Deployed checkout v2.4.
Typemarker_typetext
A group for similar markers, such as deploy; each type has its own color.
Linkurltext
A page the marker's text opens, such as the build or release.
Startstart_timedate and time
When it happened. Defaults to now.
Endend_timedate and time
When it ended, to mark a span such as a 5-minute deploy.

Outputs

markerobject
The marker
Example output
{
  "marker": {
    "color": "#0298ec",
    "created_at": "2026-11-18T10:00:05Z",
    "end_time": 1763460300,
    "id": "d1c84ec0",
    "message": "Deployed checkout v2.4",
    "start_time": 1763460000,
    "type": "deploy",
    "updated_at": "2026-11-18T10:00:05Z",
    "url": "https://ci.example.com/builds/123"
  }
}

Create trigger

Create a Honeycomb trigger that checks a calculation on a schedule and alerts when it crosses a threshold, such as more than 100 server errors in 15 minutes.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
NamenametextRequired
Shown in Honeycomb and in each alert.
Calculationcalculationtext
What to calculate. Defaults to a count of events.One of: COUNT (Count of events), COUNT_DISTINCT (Count of distinct values), SUM, AVG (Average), MIN (Minimum), MAX (Maximum), P50 (Median (50th percentile)), P75 (75th percentile), P90 (90th percentile), P95 (95th percentile), P99 (99th percentile), P999 (99.9th percentile). Default: COUNT.
Fieldcolumntext
The field to calculate on, such as duration_ms. Needed for every calculation except a count of events.
Wherefilterslist
Conditions events must meet, one per line, such as status_code >= 500, service.name = checkout or error exists.
Matchmatchtext
Whether events must meet all the conditions or any one.One of: all (All conditions), any (Any condition). Default: all.
Fire when the result isthreshold_optext
Whether the trigger fires above or below the threshold. Defaults to above.One of: > (Above), >= (At or above), < (Below), <= (At or below). Default: >.
Thresholdthreshold_valuenumberRequired
The number the result is compared with, such as 100.
Checkfrequency_minutestext
How often Honeycomb checks. Defaults to every 15 minutes.One of: 1 (Every minute), 5 (Every 5 minutes), 10 (Every 10 minutes), 15 (Every 15 minutes), 30 (Every 30 minutes), 60 (Every hour), 120 (Every 2 hours), 360 (Every 6 hours), 720 (Every 12 hours), 1440 (Every day). Default: 15.
Look back overlookback_minutestext
How much time each check covers: from the time between checks to 4 times it. Defaults to the time between checks.One of: 1 (1 minute), 5 (5 minutes), 10 (10 minutes), 15 (15 minutes), 30 (30 minutes), 60 (1 hour), 120 (2 hours), 240 (4 hours), 360 (6 hours), 720 (12 hours), 1440 (24 hours).
Alertalert_ontext
Alert once when the threshold is crossed (default), or at every check.One of: on_change (Once, when it crosses the threshold), on_true (At every check while it is over the threshold). Default: on_change.
Notifyrecipientslist
Who Honeycomb alerts: the email addresses, Slack channels and others set up under Team Settings > Integrations.
Descriptiondescriptiontext
Shown on the trigger's page, such as a runbook link.
Turned offdisabledtrue/false
Turn the trigger off, so it isn't checked and sends no alerts.

Outputs

triggerobject
The trigger
Example output
{
  "trigger": {
    "alert_type": "on_change",
    "created_at": "2026-11-01T09:00:00Z",
    "dataset_slug": "checkout",
    "description": "More than 100 server errors in 15 minutes",
    "disabled": false,
    "frequency": 900,
    "id": "fS4WfA82",
    "name": "Checkout errors",
    "query": {
      "calculations": [
        {
          "op": "COUNT"
        }
      ],
      "filters": [
        {
          "column": "status_code",
          "op": ">=",
          "value": 500
        }
      ],
      "time_range": 900
    },
    "query_id": "dSlAHrWyBu",
    "recipients": [
      {
        "id": "yUheCUmgZ8q",
        "target": "oncall@example.com",
        "type": "email"
      }
    ],
    "tags": [
      {
        "key": "team",
        "value": "payments"
      }
    ],
    "threshold": {
      "exceeded_limit": 1,
      "op": ">",
      "value": 100
    },
    "triggered": false,
    "updated_at": "2026-11-01T09:00:00Z"
  }
}

Delete marker

Delete a marker from a dataset.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Markermarker_idtextRequired
The marker. Pick one, or give its ID from an earlier step.

Outputs

deletedtrue/false
Always true once done
marker_idtext
The marker deleted
Example output
{
  "deleted": true,
  "marker_id": "d1c84ec0"
}

Delete trigger

Delete a Honeycomb trigger, so it no longer checks or alerts.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Triggertrigger_idtextRequired
The Honeycomb trigger. Pick one, or give its ID from an earlier step.

Outputs

deletedtrue/false
Always true once done
trigger_idtext
The trigger deleted
Example output
{
  "deleted": true,
  "trigger_id": "fS4WfA82"
}

Get dataset

Get one dataset: its description, how many fields it has and when it last received an event.

Inputs

DatasetdatasettextRequired
The dataset. Pick one, or give its slug from an earlier step.

Outputs

datasetobject
The dataset
Example output
{
  "dataset": {
    "created_at": "2026-01-12T09:00:00Z",
    "description": "The checkout service",
    "expand_json_depth": 0,
    "last_written_at": "2026-11-18T10:04:00Z",
    "name": "checkout",
    "regular_columns_count": 42,
    "settings": {
      "delete_protected": false
    },
    "slug": "checkout"
  }
}

Get SLO

Get one SLO, optionally with its status, error budget left and compliance (Honeycomb Enterprise).

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
SLOslo_idtextRequired
The SLO. Pick one, or give its ID from an earlier step.
Include status and budgetinclude_reporttrue/false
Also return its status, error budget left, compliance and burn rate. Needs Honeycomb Enterprise.

Outputs

sloobject
The SLO
Example output
{
  "slo": {
    "budget_remaining": 48.2,
    "burn_rate": 0.8,
    "compliance": 99.95,
    "created_at": "2026-02-01T09:00:00Z",
    "dataset_slugs": [
      "checkout"
    ],
    "description": "99.9% of checkouts succeed",
    "id": "bZ1aRHAUsjG",
    "name": "Checkout succeeds",
    "reset_at": "2026-06-01T00:00:00Z",
    "sli": {
      "alias": "checkout_ok"
    },
    "status": "normal",
    "tags": [],
    "target_per_million": 999000,
    "time_period_days": 30,
    "updated_at": "2026-02-01T09:00:00Z"
  }
}

Get trigger

Get one Honeycomb trigger: its query, threshold, schedule, who it notifies and whether it is firing.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Triggertrigger_idtextRequired
The Honeycomb trigger. Pick one, or give its ID from an earlier step.

Outputs

triggerobject
The trigger
Example output
{
  "trigger": {
    "alert_type": "on_change",
    "created_at": "2026-11-01T09:00:00Z",
    "dataset_slug": "checkout",
    "description": "More than 100 server errors in 15 minutes",
    "disabled": false,
    "frequency": 900,
    "id": "fS4WfA82",
    "name": "Checkout errors",
    "query": {
      "calculations": [
        {
          "op": "COUNT"
        }
      ],
      "filters": [
        {
          "column": "status_code",
          "op": ">=",
          "value": 500
        }
      ],
      "time_range": 900
    },
    "query_id": "dSlAHrWyBu",
    "recipients": [
      {
        "id": "yUheCUmgZ8q",
        "target": "oncall@example.com",
        "type": "email"
      }
    ],
    "tags": [
      {
        "key": "team",
        "value": "payments"
      }
    ],
    "threshold": {
      "exceeded_limit": 1,
      "op": ">",
      "value": 100
    },
    "triggered": false,
    "updated_at": "2026-11-01T09:00:00Z"
  }
}

List boards

List the boards in your environment, with a link to each.

Inputs

None.

Outputs

boardslist
The boards
countnumber
How many
Example output
{
  "boards": [
    {
      "description": "Errors and latency for checkout",
      "id": "2NeeaE9bBLd",
      "links": {
        "board_url": "https://ui.honeycomb.io/acme/environments/prod/board/2NeeaE9bBLd"
      },
      "name": "Checkout health",
      "panels": [],
      "tags": [],
      "type": "flexible"
    }
  ],
  "count": 1
}

List burn alerts

List an SLO's burn alerts, which warn when its error budget runs down, and whether each is firing.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
SLOslo_idtextRequired
The SLO. Pick one, or give its ID from an earlier step.

Outputs

burn_alertslist
The burn alerts
countnumber
How many
Example output
{
  "burn_alerts": [
    {
      "alert_type": "exhaustion_time",
      "created_at": "2026-02-01T09:00:00Z",
      "description": "Use the checkout runbook",
      "id": "fS7vfB81Wcy",
      "slo": {
        "id": "bZ1aRHAUsjG"
      },
      "triggered": false,
      "updated_at": "2026-02-01T09:00:00Z"
    }
  ],
  "count": 1
}

List datasets

List the datasets in your environment, with when each last received an event.

Inputs

None.

Outputs

countnumber
How many
datasetslist
The datasets
Example output
{
  "count": 1,
  "datasets": [
    {
      "created_at": "2026-01-12T09:00:00Z",
      "description": "The checkout service",
      "expand_json_depth": 0,
      "last_written_at": "2026-11-18T10:04:00Z",
      "name": "checkout",
      "regular_columns_count": 42,
      "settings": {
        "delete_protected": false
      },
      "slug": "checkout"
    }
  ]
}

List fields

List the fields in a dataset's events, with each one's type and when an event last carried it.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.

Outputs

columnslist
The fields
countnumber
How many
Example output
{
  "columns": [
    {
      "created_at": "2026-01-12T09:00:00Z",
      "description": "",
      "hidden": false,
      "id": "yUheCUmgZ8p",
      "key_name": "duration_ms",
      "last_written": "2026-11-18T10:04:00Z",
      "type": "float",
      "updated_at": "2026-01-12T09:00:00Z"
    }
  ],
  "count": 1
}

List markers

List a dataset's markers, newest first.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Typemarker_typetext
Only markers of this type, such as deploy.
At mostlimitnumber
How many markers to return. Defaults to 100.From 1 to 1000.

Outputs

countnumber
How many
markerslist
The markers, newest first
Example output
{
  "count": 1,
  "markers": [
    {
      "color": "#0298ec",
      "created_at": "2026-11-18T10:00:05Z",
      "end_time": 1763460300,
      "id": "d1c84ec0",
      "message": "Deployed checkout v2.4",
      "start_time": 1763460000,
      "type": "deploy",
      "updated_at": "2026-11-18T10:00:05Z",
      "url": "https://ci.example.com/builds/123"
    }
  ]
}

List recipients

List where Honeycomb can send alerts: email addresses, Slack channels, PagerDuty and webhooks. Secrets are hidden.

Inputs

None.

Outputs

countnumber
How many
recipientslist
The recipients
Example output
{
  "count": 1,
  "recipients": [
    {
      "created_at": "2026-01-12T09:00:00Z",
      "details": {
        "email_address": "oncall@example.com"
      },
      "id": "yUheCUmgZ8q",
      "type": "email",
      "updated_at": "2026-01-12T09:00:00Z"
    }
  ]
}

List SLOs

List the service level objectives (SLOs) on a dataset. Needs Honeycomb Pro or Enterprise.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.

Outputs

countnumber
How many
sloslist
The SLOs
Example output
{
  "count": 1,
  "slos": [
    {
      "budget_remaining": 48.2,
      "burn_rate": 0.8,
      "compliance": 99.95,
      "created_at": "2026-02-01T09:00:00Z",
      "dataset_slugs": [
        "checkout"
      ],
      "description": "99.9% of checkouts succeed",
      "id": "bZ1aRHAUsjG",
      "name": "Checkout succeeds",
      "reset_at": "2026-06-01T00:00:00Z",
      "sli": {
        "alias": "checkout_ok"
      },
      "status": "normal",
      "tags": [],
      "target_per_million": 999000,
      "time_period_days": 30,
      "updated_at": "2026-02-01T09:00:00Z"
    }
  ]
}

List triggers

List the Honeycomb triggers (alerts) on a dataset, and whether each is firing.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Statusstatustext
Only triggers that are firing, not firing, or turned off.One of: firing (Firing now), ok (Not firing), disabled (Turned off).

Outputs

countnumber
How many
triggerslist
The triggers
Example output
{
  "count": 1,
  "triggers": [
    {
      "alert_type": "on_change",
      "created_at": "2026-11-01T09:00:00Z",
      "dataset_slug": "checkout",
      "description": "More than 100 server errors in 15 minutes",
      "disabled": false,
      "frequency": 900,
      "id": "fS4WfA82",
      "name": "Checkout errors",
      "query": {
        "calculations": [
          {
            "op": "COUNT"
          }
        ],
        "filters": [
          {
            "column": "status_code",
            "op": ">=",
            "value": 500
          }
        ],
        "time_range": 900
      },
      "query_id": "dSlAHrWyBu",
      "recipients": [
        {
          "id": "yUheCUmgZ8q",
          "target": "oncall@example.com",
          "type": "email"
        }
      ],
      "tags": [
        {
          "key": "team",
          "value": "payments"
        }
      ],
      "threshold": {
        "exceeded_limit": 1,
        "op": ">",
        "value": 100
      },
      "triggered": false,
      "updated_at": "2026-11-01T09:00:00Z"
    }
  ]
}

Run query

Count or calculate over a dataset's events, such as the 99th percentile of duration_ms by service in the last hour, and get the results. Needs Honeycomb Enterprise.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Calculationcalculationtext
What to calculate. Defaults to a count of events.One of: COUNT (Count of events), COUNT_DISTINCT (Count of distinct values), SUM, AVG (Average), MIN (Minimum), MAX (Maximum), P50 (Median (50th percentile)), P75 (75th percentile), P90 (90th percentile), P95 (95th percentile), P99 (99th percentile), P999 (99.9th percentile). Default: COUNT.
Fieldcolumntext
The field to calculate on, such as duration_ms. Needed for every calculation except a count of events.
Wherefilterslist
Conditions events must meet, one per line, such as status_code >= 500, service.name = checkout or error exists.
Matchmatchtext
Whether events must meet all the conditions or any one.One of: all (All conditions), any (Any condition). Default: all.
Group bygroup_bylist
Fields to split the results by, such as service.name.
Time rangetime_rangetext
How far back to look. Defaults to the last 2 hours.One of: 600 (Last 10 minutes), 1800 (Last 30 minutes), 3600 (Last hour), 7200 (Last 2 hours), 21600 (Last 6 hours), 86400 (Last 24 hours), 604800 (Last 7 days). Default: 7200.
Fromstart_timedate and time
The start of a fixed time range, instead of Time range. Fill in To as well; at most 7 days, within the past 7 days.
Toend_timedate and time
The end of a fixed time range.
At mostlimitnumber
How many result rows (groups) to return. Defaults to 100.From 1 to 1000.

Outputs

countnumber
How many
graph_image_urltext
A picture of the graph
query_idtext
The query's ID
query_result_idtext
The ID of this run of the query
query_urltext
The results in Honeycomb
resultslist
One row per group: the group-by fields and the calculation, such as COUNT or P99(duration_ms)
Example output
{
  "count": 1,
  "graph_image_url": "https://ui.honeycomb.io/acme/datasets/checkout/result/dfg456/snapshot",
  "query_id": "abc3419d",
  "query_result_id": "dfg456",
  "query_url": "https://ui.honeycomb.io/acme/datasets/checkout/result/dfg456",
  "results": [
    {
      "P99(duration_ms)": 857.03,
      "service.name": "checkout"
    }
  ]
}

Send event

Send one event to a dataset, such as a job that finished with its duration. A new dataset name creates the dataset.

Inputs

DatasetdatasettextRequired
The dataset to send to. Pick one, or type a new name to create it.
FieldsfieldsobjectRequired
The event's fields and values, such as job: nightly-import and duration_ms: 5400.
Timeevent_timedate and time
When it happened. Defaults to now.
Sample ratesample_ratenumber
If you send 1 in every N events, N, so Honeycomb counts this one N times. Defaults to 1.At least 1.

Outputs

datasettext
The dataset they went to
sentnumber
How many events Honeycomb stored
Example output
{
  "dataset": "checkout",
  "sent": 1
}

Send events

Send a list of events to a dataset in one go, such as rows from an earlier step. Fails, naming each event, if Honeycomb refuses any.

Inputs

DatasetdatasettextRequired
The dataset to send to. Pick one, or type a new name to create it.
EventseventslistRequired
A list of events, each a set of fields and values. An item may also give data, time and samplerate as Honeycomb does.

Outputs

datasettext
The dataset they went to
sentnumber
How many events Honeycomb stored
Example output
{
  "dataset": "checkout",
  "sent": 25
}

Update marker

Change a marker's message, type, link or times, such as adding the end of a deploy. Fields left blank keep what the marker has.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Markermarker_idtextRequired
The marker. Pick one, or give its ID from an earlier step.
Messagemessagetext
What happened, such as Deployed checkout v2.4. Leave blank to keep it.
Typemarker_typetext
A group for similar markers, such as deploy; each type has its own color. Leave blank to keep it.
Linkurltext
A page the marker's text opens, such as the build or release. Leave blank to keep it.
Startstart_timedate and time
When it happened. Leave blank to keep it.
Endend_timedate and time
When it ended, to mark a span such as a 5-minute deploy. Leave blank to keep it.

Outputs

markerobject
The marker
Example output
{
  "marker": {
    "color": "#0298ec",
    "created_at": "2026-11-18T10:00:05Z",
    "end_time": 1763460300,
    "id": "d1c84ec0",
    "message": "Deployed checkout v2.4",
    "start_time": 1763460000,
    "type": "deploy",
    "updated_at": "2026-11-18T10:00:05Z",
    "url": "https://ci.example.com/builds/123"
  }
}

Update trigger

Change a Honeycomb trigger's name, threshold, schedule or who it notifies, or turn it off or on. Fields left blank stay as they are.

Inputs

DatasetdatasettextRequired
The dataset. Pick one (or every dataset), or give its slug from an earlier step.
Triggertrigger_idtextRequired
The Honeycomb trigger. Pick one, or give its ID from an earlier step.
Namenametext
A new name. Leave blank to keep it.
Descriptiondescriptiontext
A new description. Leave blank to keep it.
Fire when the result isthreshold_optext
Above or below. Leave blank to keep it.One of: > (Above), >= (At or above), < (Below), <= (At or below).
Thresholdthreshold_valuenumber
A new threshold. Leave blank to keep it.
Checkfrequency_minutestext
How often to check. Leave blank to keep it; it must suit how far back the trigger looks.One of: 1 (Every minute), 5 (Every 5 minutes), 10 (Every 10 minutes), 15 (Every 15 minutes), 30 (Every 30 minutes), 60 (Every hour), 120 (Every 2 hours), 360 (Every 6 hours), 720 (Every 12 hours), 1440 (Every day).
Alertalert_ontext
Once, or at every check. Leave blank to keep it.One of: on_change (Once, when it crosses the threshold), on_true (At every check while it is over the threshold).
Notifyrecipientslist
Replaces who Honeycomb alerts. Leave blank to keep them.
Turned offdisabledtrue/false
Turn the trigger off (true) or on (false). Leave blank to keep it.

Outputs

triggerobject
The trigger
Example output
{
  "trigger": {
    "alert_type": "on_change",
    "created_at": "2026-11-01T09:00:00Z",
    "dataset_slug": "checkout",
    "description": "More than 100 server errors in 15 minutes",
    "disabled": false,
    "frequency": 900,
    "id": "fS4WfA82",
    "name": "Checkout errors",
    "query": {
      "calculations": [
        {
          "op": "COUNT"
        }
      ],
      "filters": [
        {
          "column": "status_code",
          "op": ">=",
          "value": 500
        }
      ],
      "time_range": 900
    },
    "query_id": "dSlAHrWyBu",
    "recipients": [
      {
        "id": "yUheCUmgZ8q",
        "target": "oncall@example.com",
        "type": "email"
      }
    ],
    "tags": [
      {
        "key": "team",
        "value": "payments"
      }
    ],
    "threshold": {
      "exceeded_limit": 1,
      "op": ">",
      "value": 100
    },
    "triggered": false,
    "updated_at": "2026-11-01T09:00:00Z"
  }
}

On this page