Join our upcoming Office Hours: Future Proofing your Splunk Apps.Register here

 Send data to Splunk Observability Cloud

The data ingest APIs let you send metrics, traces, and custom events to your organization.

Info Circle

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

Info Circle

NOTE: This endpoint requires an organization access token in which one of authScopes array elements is INGEST. 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

Info Circle

NOTE: This endpoint requires an organization access token in which one of authScopes array elements is INGEST. 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

Info Circle

NOTE: This endpoint requires an organization access token in which one of authScopes array elements is INGEST. 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.