Send data to Splunk Observability Cloud
The data ingest APIs let you send metrics, traces, and custom events to your organization.
When you send an API request, you need to use the endpoint specific to your organization's realm. To learn more, see Realms in endpoints.
Splunk Observability Cloud provides the following data ingest APIs:
- The Metrics API sends metrics. This helps you evaluate and test charts and detectors even before you configure your systems to send metrics using integrations.
- The Backfill API lets you add historical data to your metric time series.
- The Metadata API helps you manage metrics metadata such as dimensions, custom properties, and tags. This metadata provides additional searching, filtering, and grouping to your metrics.
- The Events API lets you add custom events to your organization.
- The Trace Ingest API lets you send tracing data to your organization.
To learn more about the data model, see Data types in Splunk Observability Cloud.
Send data measurements
NOTE: This endpoint requires an organization access token in which one of
authScopes
array elements isINGEST
. To learn more, see the Organization access tokens topic.
Use the following operation to send your own monitoring data measurements in real time. This operation is also known as data ingest.
POST https://ingest.<REALM>.signalfx.com/v2/datapoint
This endpoint supports streaming and non-streaming requests.
To learn more about the Metrics API, see Send Monitoring Metrics and Custom Events.
To learn more about data points, and the data model on which they’re based, see Splunk Observability Cloud Data Model Basics.
To learn how to send metrics from a cloud service such as AWS, see Data collection integrations.
Send historical data
NOTE: This endpoint requires an organization access token in which one of
authScopes
array elements isINGEST
. To learn more, see the Organization access tokens topic.
Use the following operation to add historical data points to an existing metric time series(MTS):
POST https://backfill.<REALM>.signalfx.com/v1/backfill
Manage metadata
Use the metadata API endpoints to manage metadata such as dimensions and tags. To learn more, see Splunk Observability Cloud Metrics Metadata.
Send custom events
NOTE: This endpoint requires an organization access token in which one of
authScopes
array elements isINGEST
. To learn more, see the Organization access tokens topic.
Use the following endpoint to send custom events:
POST https://api.<REALM>.signalfx.com/v2/event
To learn more, see Send Monitoring Metrics and Custom Events.
Send traces
Use the following endpoint to send traces:
POST https://ingest.<REALM>.signalfx.com/v2/trace
`
To learn more, see Send APM traces.