# Digital Ocean Insights API

**Canonical:** https://apis.io/apis/digital-ocean/digital-ocean-insights-api/  
**Provider:** Digital Ocean — https://apis.io/providers/digital-ocean/  
**Base URL:** https://api.digitalocean.com  
**Documentation:** https://docs.digitalocean.com/reference/api/api-reference/

Digital Ocean Insights API is one of 63 APIs that [Digital Ocean](https://apis.io/providers/digital-ocean/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Insights. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The DigitalOcean Insights API provides observability resources for monitoring your infrastructure, including alert rules that evaluate metrics, notification channels that deliver alert events, read-only alert instances that record when alert rules fire, PromQL, logs, spans, and traces query interfaces, and per-resource enablement of the metrics, logs, and traces signals.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/insights/alert-instances` | Get insights alert instances |
| GET | `/v2/insights/alert-instances/{id}` | Get insights alert instances by id |
| GET | `/v2/insights/alert-rules` | Get insights alert rules |
| POST | `/v2/insights/alert-rules` | Create insights alert rules |
| GET | `/v2/insights/alert-rules/{id}` | Get insights alert rules by id |
| PUT | `/v2/insights/alert-rules/{id}` | Replace insights alert rules by id |
| DELETE | `/v2/insights/alert-rules/{id}` | Delete insights alert rules by id |
| GET | `/v2/insights/notification-channels` | Get insights notification channels |
| POST | `/v2/insights/notification-channels` | Create insights notification channels |
| GET | `/v2/insights/notification-channels/{id}` | Get insights notification channels by id |
| PUT | `/v2/insights/notification-channels/{id}` | Replace insights notification channels by id |
| DELETE | `/v2/insights/notification-channels/{id}` | Delete insights notification channels by id |
| GET | `/v2/insights/query/{region}/prom/api/v1/query` | Get insights query by region prom api query |
| POST | `/v2/insights/query/{region}/prom/api/v1/query` | Create insights query by region prom api query |
| GET | `/v2/insights/query/{region}/prom/api/v1/query_range` | Get insights query by region prom api query range |
| POST | `/v2/insights/query/{region}/prom/api/v1/query_range` | Create insights query by region prom api query range |
| GET | `/v2/insights/query/{region}/prom/api/v1/labels` | Get insights query by region prom api labels |
| POST | `/v2/insights/query/{region}/prom/api/v1/labels` | Create insights query by region prom api labels |
| GET | `/v2/insights/query/{region}/prom/api/v1/label/{name}/values` | Get insights query by region prom api label by name values |
| GET | `/v2/insights/query/{region}/prom/api/v1/series` | Get insights query by region prom api series |
| POST | `/v2/insights/query/{region}/prom/api/v1/series` | Create insights query by region prom api series |
| POST | `/v2/insights/query/{region}/logs/search` | Create insights query by region logs search |
| POST | `/v2/insights/query/{region}/traces/search` | Create insights query by region traces search |
| GET | `/v2/insights/query/{region}/traces/{trace_id}` | Get insights query by region traces by trace id |
| POST | `/v2/insights/query/{region}/spans/search` | Create insights query by region spans search |
| GET | `/v2/insights/resources` | Get insights resources |
| GET | `/v2/insights/resources/{resource_urn}` | Get insights resources by resource urn |
| PUT | `/v2/insights/resources/{resource_urn}/signals` | Replace insights resources by resource urn signals |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/digital-ocean/openapi/digital-ocean-insights-api-openapi.yml
- **Documentation** — https://docs.digitalocean.com/reference/api/api-reference/
- **SourceCode** — https://github.com/digitalocean/openapi

## Other Digital Ocean APIs (12)

- [Digital Ocean Account API](https://apis.io/apis/digital-ocean/digital-ocean-account-api/)
- [Digital Ocean Actions API](https://apis.io/apis/digital-ocean/digital-ocean-actions-api/)
- [Digital Ocean Apps API](https://apis.io/apis/digital-ocean/digital-ocean-apps-api/)
- [Digital Ocean Billing API](https://apis.io/apis/digital-ocean/digital-ocean-billing-api/)
- [Digital Ocean Certificates API](https://apis.io/apis/digital-ocean/digital-ocean-certificates-api/)
- [Digital Ocean Databases API](https://apis.io/apis/digital-ocean/digital-ocean-databases-api/)
- [Digital Ocean Domains API](https://apis.io/apis/digital-ocean/digital-ocean-domains-api/)
- [Digital Ocean Droplets API](https://apis.io/apis/digital-ocean/digital-ocean-droplets-api/)
- [Digital Ocean Firewalls API](https://apis.io/apis/digital-ocean/digital-ocean-firewalls-api/)
- [Digital Ocean Floating IPs API](https://apis.io/apis/digital-ocean/digital-ocean-floating-ips-api/)
- [Digital Ocean Functions API](https://apis.io/apis/digital-ocean/digital-ocean-functions-api/)
- [Digital Ocean Images API](https://apis.io/apis/digital-ocean/digital-ocean-images-api/)

## Tags

Insights

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/digital-ocean/digital-ocean-insights-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/digital-ocean/.