AceDocs
Integrations

Integrations

Every tool Ace connects to, what Ace reads and can change in each, which ones open incidents, and how connecting a tool works.

Each integration has its own credential and permissions, and investigations only ever read. Ace changes something in a tool only when the credential allows it and an admin has turned on actions for that integration.

How integrations work

Admins connect integrations under Settings > Data sources, except Slack, which lives under Settings > Slack. Most tools take an API key or token. AWS uses a guided setup that creates a read-only IAM role, Kubernetes runs a connector as Deployments in your cluster, and GitHub and Slack use the Ace apps.

A workload is something you run, such as an API, a checkout flow or a background worker. An integration's alerts open incidents only on workloads that route it, so in the workload's settings, select the integration under Investigation triggers > Integration alerts.

Many tools send alerts by webhook. The integration's page in Ace shows the URL, and for some tools Ace adds the webhook itself. Ace polls some other tools every 2 minutes.

Investigation sources in the workload's settings sets which connected sources its investigations read. Once you save the list, Ace reads only those sources plus any source that routes the workload's alerts, so add any source you connect later. Until you save a list, the workload's alert sources decide what Ace reads. Code comes from the GitHub repositories linked to the workload.

Integrations that support actions show Allow Ace to run approved actions, and monitoring tools show Allow Ace to update this tool during incidents instead. Until an admin turns it on, Ace changes nothing in that tool. See Actions and approvals.

Disconnect on an integration's page removes the connection, and where it can, Ace also removes what it set up in the tool, such as its webhook. Afterwards, revoke the credential in the tool itself, using the steps on each integration's page.

Cloud and infrastructure

IntegrationOpens incidentsAce can change
AWSYes, from CloudWatch alarmsNothing with the read role. With the optional actions role, the services you choose, after approval
KubernetesYes, from failing pods, rollouts and nodesNothing with the read connector. With a separate write connector, rollouts, scaling and more, after approval
CloudflareYes, from Cloudflare notificationsCache purge, Worker rollback, load balancer failover, security level, WAF rules, after approval

Code and deploys

IntegrationOpens incidentsAce can change
GitHubNoFix and revert pull requests, and your deploy workflow to roll back or redeploy
VercelYes, from Vercel alerts. Deploys also join the change timelineRollback, promotion, redeploy and more, once actions are allowed

Collaboration

IntegrationOpens incidentsAce can change
SlackStart an investigation with @Ace investigate <workload>Posts in Slack. Nothing else

Observability

IntegrationOpens incidentsAce can change
DatadogYes, from monitor notificationsA downtime on the paging monitor during an approved fix, if allowed
PrometheusYes, from Alertmanager alertsNothing (read-only)
GrafanaYes, from Grafana alertsAnnotations, and a silence on the paging rule during an approved fix
New RelicYes, from alert issuesA muting rule on the paging condition during an approved fix
HoneycombYes, from triggers and SLO burn alertsMarkers when an incident opens and resolves
ElasticsearchNoNothing (read-only)
AxiomYes, from monitor alertsAnnotations when an incident opens and resolves
LogfireNoNothing (read-only)
SentryYes, from Sentry alertsIssue status and assignee, if allowed

AI applications

IntegrationOpens incidentsAce can change
LangSmithNoNothing (read-only)
LiteLLMNo. Read during investigationsModel fallbacks, budgets and rate limits, after approval

Jobs and workflows

IntegrationOpens incidentsAce can change
Trigger.devYes, from failed production runsReplay or cancel runs, pause or resume a queue, once actions are allowed
InngestYes, from failed production runsRerun or cancel runs, pause or resume a function, once actions are allowed

Databases

IntegrationOpens incidentsAce can change
SupabaseYes, from project healthPooler size, read-only mode, disk size, restart. A person always approves
PlanetScaleNo. Read during investigationsDeploy requests, and bounded backfills with a write password. A person always approves

Product and feature flags

IntegrationOpens incidentsAce can change
PostHogYes, from insight alertsFeature flag rollout and on/off, once actions are allowed
LaunchDarklyNo. Changes join the change timelineFlag on/off, rollout, restore an earlier version, once actions are allowed

Paging and incident management

IntegrationOpens incidentsAce can change
PagerDutyJoins the open incident. A high-urgency page opens one if none is openNothing in your incidents (read-only)
incident.ioJoins the open incident, or opens one if none is openNothing (read-only)

Don't see your tool?

Tell us which tool you use and what Ace would need to read from it: talk to our team.

Next steps

On this page