Better Stack

better_stack

Better Stack provides monitoring, logging, and incident management solutions to help teams ensure the reliability and performance of their applications.

Server Monitoring Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (26)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create Escalation PolicyBETTER_STACK_CREATE_ESCALATION_POLICYAcción

Tool to create a new escalation policy. use when defining how incidents should escalate across team members.

Parámetros de entrada

namestringObligatorio
Name of the escalation policy
stepsobject[]Obligatorio
Ordered list of escalation policy steps
team_namestring
Team owning the policy (required with global API token)
repeat_countinteger
How many times to repeat the policy if unacknowledged
repeat_delayinteger
Seconds to wait between policy repetitions

Parámetros de salida

dataobjectObligatorio
Response data payload
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Heartbeat GroupBETTER_STACK_CREATE_HEARTBEAT_GROUPAcción

Tool to create a new heartbeat group. use when you need to organize related heartbeat checks under a single, logical group. example prompt: "create a new heartbeat group named 'backend services'."

Parámetros de entrada

namestringObligatorio
Name of the group visible in the dashboard.
pausedboolean
Set to true to pause monitoring for all existing heartbeats in the group; false (default) to resume monitoring.
team_namestring
Team which should own the resource. Required when using a global API token.
sort_indexinteger
Zero-based index to control sort order of heartbeat groups.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Outgoing Webhook IntegrationBETTER_STACK_CREATE_OUTGOING_WEBHOOKAcción

Tool to create a new outgoing webhook integration. use when you need to register an endpoint to receive event notifications from better stack.

Parámetros de entrada

urlstringObligatorio
The endpoint URL of the outgoing webhook integration.
namestringObligatorio
The name of the outgoing webhook integration.
team_namestring
Required if using a global API token to specify the team which should own the resource.
trigger_typestringObligatorioenum
The type of event that triggers the webhook.
on_call_changeincident_changemonitor_change
on_incident_startedboolean
Trigger when an incident starts (only if trigger_type is 'incident_change').
on_incident_resolvedboolean
Trigger when an incident is resolved (only if trigger_type is 'incident_change').
on_incident_acknowledgedboolean
Trigger when an incident is acknowledged (only if trigger_type is 'incident_change').
custom_webhook_template_attributesobject
Custom webhook template attributes such as HTTP method, headers, and body.

Parámetros de salida

dataobjectObligatorio
errorstring
Error if any occurred during the execution of the action
includedobject[]Obligatorio
Included related resources, currently empty.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Source GroupBETTER_STACK_CREATE_SOURCE_GROUPAcción

Tool to create a new source group. use when you have finalized the group name (and optional sort index) and need to organize related log sources under that group.

Parámetros de entrada

namestringObligatorio
The name of the group that you can see in the dashboard.
team_namestring
Required if using a global API token to specify the team which should own the resource.
sort_indexinteger
Set sort_index to specify how to sort your source groups. Must be non-negative.

Parámetros de salida

dataobjectObligatorio
The newly created source group resource.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Escalation PolicyBETTER_STACK_DELETE_ESCALATION_POLICYAcción

Tool to delete an escalation policy by id. use when you need to permanently remove an existing escalation policy after confirming its id.

Parámetros de entrada

policy_idintegerObligatorio
The ID of the escalation policy you want to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Source GroupBETTER_STACK_DELETE_SOURCE_GROUPAcción

Tool to delete a source group by id. use when you need to permanently remove an existing source group after confirming it is no longer needed.

Parámetros de entrada

source_group_idstringObligatorio
The ID of the source group to delete.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get HeartbeatBETTER_STACK_GET_HEARTBEATAcción

Tool to get a single heartbeat by id. use when you need to fetch details of a specific heartbeat.

Parámetros de entrada

heartbeat_idstringObligatorio
The ID of the requested heartbeat

Parámetros de salida

dataobjectObligatorio
The heartbeat object
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Heartbeat AvailabilityBETTER_STACK_GET_HEARTBEAT_AVAILABILITYAcción

Tool to retrieve availability summary for a specific heartbeat. use when you need availability metrics for a heartbeat within an optional date range.

Parámetros de entrada

to_datestring
End date (inclusive) for the summary in YYYY-MM-DD format
from_datestring
Start date (inclusive) for the summary in YYYY-MM-DD format
heartbeat_idstringObligatorio
ID of the heartbeat to retrieve availability for

Parámetros de salida

dataobjectObligatorio
Availability summary data
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get MonitorBETTER_STACK_GET_MONITORAcción

Tool to get a single monitor. use when you need full details of a specific monitor by its id.

Parámetros de entrada

monitor_idstringObligatorio
The ID of the monitor to retrieve

Parámetros de salida

dataobjectObligatorio
Monitor object containing its details
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Monitor AvailabilityBETTER_STACK_GET_MONITOR_AVAILABILITYAcción

Tool to return an availability summary for a specific monitor. use when you need uptime percentage and incident details within an optional date range.

Parámetros de entrada

to_datestring
End date (inclusive) for the summary in YYYY-MM-DD format
from_datestring
Start date (inclusive) for the summary in YYYY-MM-DD format
monitor_idstringObligatorio
The ID of the monitor to retrieve availability for

Parámetros de salida

dataobjectObligatorio
Availability summary data
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Monitor Response TimesBETTER_STACK_GET_MONITOR_RESPONSE_TIMESAcción

Tool to return response times for a specific monitor. use when you have a monitor id and need performance metrics over the last 24 hours.

Parámetros de entrada

tostring
End date (inclusive) for the response times in ISO 8601 format
fromstring
Start date (inclusive) for the response times in ISO 8601 format
limitinteger
Maximum number of records to return
monitor_idstringObligatorio
The ID of the monitor to retrieve response times for

Parámetros de salida

dataobjectObligatorio
Top-level data object in the response.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Status PageBETTER_STACK_GET_STATUS_PAGEAcción

Tool to get a single status page by id. use when you need detailed information about a specific status page.

Parámetros de entrada

status_page_idstringObligatorio
The ID of the status page to retrieve

Parámetros de salida

dataobjectObligatorio
The status page resource
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Telemetry API TokenBETTER_STACK_GET_TELEMETRY_API_TOKENAcción

Tool to retrieve the telemetry api token from the integration configuration. use when you need to authenticate telemetry api requests.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Uptime API TokenBETTER_STACK_GET_UPTIME_API_TOKENAcción

Tool to retrieve the configured uptime api token. use when you need the uptime api token for subsequent authenticated api calls.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Catalog RelationsBETTER_STACK_LIST_CATALOG_RELATIONSAcción

Tool to list all catalog relations. use when you need to retrieve all catalog relations, supports pagination.

Parámetros de entrada

pageinteger
Page number to return. Starts at 1.
per_pageinteger
Number of resources per page. Default is 50, maximum is 250.

Parámetros de salida

dataobject[]Obligatorio
List of catalog relations
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination metadata
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Google Monitoring IntegrationsBETTER_STACK_LIST_GOOGLE_MONITORING_INTEGRATIONSAcción

Tool to list all google monitoring integrations. use when you need to view your configured google monitoring on-call integrations with pagination support.

Parámetros de entrada

pageinteger
Page number to return. Starts at 1.
per_pageinteger
Number of integrations per page. Default is 50, maximum is 250.

Parámetros de salida

dataobject[]Obligatorio
List of Google Monitoring integrations.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination metadata.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Grafana IntegrationsBETTER_STACK_LIST_GRAFANA_INTEGRATIONSAcción

Tool to list all grafana integrations. use when you need to retrieve and inspect all configured grafana integrations.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobject[]Obligatorio
List of Grafana integrations.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination details.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List HeartbeatsBETTER_STACK_LIST_HEARTBEATSAcción

Tool to list all heartbeats. use when you need to retrieve your configured uptime heartbeats with optional pagination.

Parámetros de entrada

pageinteger
Page number to return. Starts at 1.

Parámetros de salida

dataobject[]Obligatorio
List of heartbeat resources
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination metadata
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List MonitorsBETTER_STACK_LIST_MONITORSAcción

Tool to list all monitors. use when you need to retrieve existing uptime monitors with optional filtering by url or name and pagination.

Parámetros de entrada

urlstring
Filter monitors by their URL property
pageinteger
Page number to return. Starts at 1.
per_pageinteger
Number of monitors per page. Default is 50, maximum is 250.
pronounceable_namestring
Filter monitors by their pronounceable name property

Parámetros de salida

dataobject[]Obligatorio
List of monitors
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination metadata
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List New Relic IntegrationsBETTER_STACK_LIST_NEW_RELIC_INTEGRATIONSAcción

Tool to list new relic integrations. use when you need to retrieve and inspect all configured new relic integrations with pagination support.

Parámetros de entrada

pageinteger
Page number to return. Starts at 1.
per_pageinteger
Number of integrations per page. Default is 50, maximum is 250.

Parámetros de salida

dataobject[]Obligatorio
List of New Relic integrations.
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination metadata.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List On-Call SchedulesBETTER_STACK_LIST_ON_CALL_SCHEDULESAcción

Tool to list all on-call schedules. use when you need to retrieve all configured on-call calendars.

Parámetros de entrada

pageinteger
Page number to return. Starts at 1.
per_pageinteger
Number of resources per page. Default is 50, maximum is 250.

Parámetros de salida

dataobject[]Obligatorio
List of on-call schedules
errorstring
Error if any occurred during the execution of the action
includedobject[]
Additional related resources
paginationobjectObligatorio
Pagination metadata
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Status Page ReportsBETTER_STACK_LIST_STATUS_PAGE_REPORTSAcción

Tool to list all reports on a status page. use when you need to retrieve existing status page reports with optional pagination via `page` and `per page`.

Parámetros de entrada

pageinteger
Page number to return. Starts at 1.
per_pageinteger
Number of reports per page. Default is 50, maximum is 250.
status_page_idstringObligatorio
The ID of the status page

Parámetros de salida

dataobject[]Obligatorio
List of status page reports
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination metadata
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Status PagesBETTER_STACK_LIST_STATUS_PAGESAcción

Tool to list all your status pages. use when you need to retrieve existing status pages with optional pagination.

Parámetros de entrada

pageinteger
Page number to return. Starts at 1.
per_pageinteger
Number of status pages per page. Default is 50; maximum is 250.

Parámetros de salida

dataobject[]Obligatorio
List of status page resources
errorstring
Error if any occurred during the execution of the action
paginationobjectObligatorio
Pagination metadata
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update HeartbeatBETTER_STACK_UPDATE_HEARTBEATAcción

Tool to update an existing heartbeat configuration. use after retrieving a heartbeat and choosing which fields to change.

Parámetros de entrada

smsboolean
Whether to send an SMS to the on-call person
callboolean
Whether to call the on-call person on failure
namestring
The name of the service for this heartbeat
pushboolean
Whether to send a push notification on failure
emailboolean
Whether to send an email to the on-call person
graceinteger
Acceptable delay beyond period in seconds (min 0)
pausedboolean
Set true to pause monitoring; false to resume
periodinteger
How often to expect the heartbeat in seconds (min 30)
policy_idstring
ID of the escalation policy to assign
team_waitinteger
Seconds to wait before escalating alert to team. Leave blank to disable team escalation.
sort_indexinteger
Index position within a heartbeat group
heartbeat_idstringObligatorio
The ID of the heartbeat to update
critical_alertboolean
Send a critical push ignoring mute and Do Not Disturb
maintenance_tostring
End of maintenance window each day (HH:MM:SS)
maintenance_daysstring[]
Days for daily maintenance window. Use both days for overnight windows.
maintenance_fromstring
Start of maintenance window each day (HH:MM:SS)
heartbeat_group_idstring
ID of the heartbeat group to assign
maintenance_timezonestring
Timezone for maintenance window. See Rails TimeZone list.

Parámetros de salida

dataobjectObligatorio
Updated heartbeat data
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Heartbeat GroupBETTER_STACK_UPDATE_HEARTBEAT_GROUPAcción

Tool to update an existing heartbeat group. use when you need to modify attributes like name, interval, or pause status.

Parámetros de entrada

namestring
Name of the group visible in the dashboard
pausedboolean
True to pause monitoring; false to resume
periodinteger
Interval in seconds for expected heartbeats (minimum 30 seconds)
sort_indexinteger
Zero-based index to control sort order of heartbeat groups
heartbeat_group_idstringObligatorio
The ID of the heartbeat group to update

Parámetros de salida

dataobjectObligatorio
The updated heartbeat group object
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Source GroupBETTER_STACK_UPDATE_SOURCE_GROUPAcción

Tool to update an existing source group. use when you need to rename or reorder a source group.

Parámetros de entrada

namestring
The new display name of the source group
sort_indexinteger
Order index to control group sorting. Must be non-negative.
source_group_idstringObligatorio
The ID of the source group you want to update

Parámetros de salida

dataobjectObligatorio
The updated source group resource.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not