Docs » Monitor and manage subscription usage and billing » Analyze Splunk APM subscription usage data for your subscription plan

Analyze Splunk APM subscription usage data for your subscription plan 🔗

Note

The following information describes aspects of your usage and consumption. For more detailed billing-related queries, contact your Splunk Account Team.

Use the APM subscription usage page to view charts that track your organization’s APM usage against its entitlements. You have to be the to view the Subscription Usage page for your organization.

You can also use the Subscription Usage page to get detailed reports for each usage period. For more information, see View Splunk APM usage reports for your subscription plan.

Prerequisite 🔗

To view the APM subscription usage page, you must have the admin or usage role.

To view your organization’s APM subscription usage, go to Settings then Subscription Usage and select the APM tab. Depending on your org subscription model, this might be Settings then Billing and Usage.

How APM calculates usage 🔗

APM uses Splunk Observability Cloud metrics to calculate usage for traces analyzed per minute (TAPM) and host subscription plans. Entitlements for host subscription plans are based on the number of hosts and containers sending data to APM. Entitlements for TAPM subscription plans are based on the number of traces you send to APM per minute.

As a result, the metrics for calculating usage depend on the subscription plan type. See the following sections for more information about how APM calculates usage for each subscription plan type. To confirm the plan for your organization, view the Subscription panel on the Subscription Usage page.

To see all of the organization metrics for APM, see Usage metrics for Splunk Observability Cloud.

To see the usage charts and metrics for your subscription plan, go to Settings > Subscription Usage and select the APM tab. Depending on your org subscription model, this might be Settings > Billing and Usage. The following sections detail the metrics for TAPM and host subscription plans respectively.

Metrics for TAPM subscription plans 🔗

The following metrics power the charts in your APM Subscription Usage page with a TAPM subscription plan:

Metric

Chart

Description

sf.org.apm.numTracesReceived

TAPM

The number of traces Splunk APM receives and processes.

sf.org.apm.numSpanBytesReceived

Trace Volume

The number of bytes Splunk APM accepts from ingested span data after decompression, filtering and throttling.

sf.org.apm.numTroubleshootingMetricSets

Troubleshooting MetricSets

The cardinality of Troubleshooting MetricSets for each 1-minute window.

Metrics for host subscription plans 🔗

The following metrics power the charts in your APM Subscription Usage page with a host subscription plan:

Metric

Chart

Description

sf.org.apm.numHosts

Hosts

The number of hosts that are actively sending data to Splunk APM.

sf.org.apm.numContainers

Containers

The number of containers actively sending data to Splunk APM.

sf.org.apm.numSpanBytesReceived

Trace Volume

The number of bytes Splunk APM accepts from ingested span data after decompression following filtering and throttling.

sf.org.apm.numTroubleshootingMetricSets

Troubleshooting MetricSets

The cardinality of Troubleshooting MetricSets for each 1-minute window.

Note

See Subscription usage report for hosts and containers for more information on how to measure subscription usage by host.

How APM calculates usage 🔗

APM provides a value for each usage metric the system collects for each subscription usage period. The billed value is the higher of these metric values:

  • The average per-minute usage throughout the usage period.

  • 50% of the peak usage for the usage period.

Every chart on the APM Billing and Usage page plots these metrics so you can monitor the billed value for each metric.

The detailed usage report for each usage period provides the billed value for each usage metric. The following example illustrates how the billed value is based on the higher value of the usage metrics for a usage period:

# The billed TAPM value for this month is: 47064

# The average TAPM value for this month is: 31516

# The halfpeak TAPM value for this month is: 47064

For more information about APM usage reports, see View Splunk APM usage reports for your subscription plan.

Subscription usage report for hosts and containers 🔗

For host subscription plans, you can request and download reports that show which hosts and containers are sending APM data over a specific minute. This can help you identify which hosts and containers are contributing to your subscription usage. You can generate and download reports within the retention period for traces. See Data retention in Application Performance Monitoring (APM) for more information.

To download a subscription usage report, do the following:

  • Go to Settings then Subscription Usage and select the APM tab.

  • Expand the Hosts chart or the Containers chart.

  • Select an hour of time in the chart.

  • Select a specific minute within the hour.

  • Select Download Data to download the CSV file.

For each selected minute, the report shows the attributes or tags associated with the hosts and containers that sent data to Splunk APM. You might see different tags, like AWSUniqueId, container_id, gcp_id, and so on depending on the source of the host or container observed and the version of your instrumentation agent.

Caution

For Kubernetes deployments, the Kubernetes attributes processor extracts default attributes extracted by the processor, such as k8s.pod.name, are required for accurate subscription usage. Don’t remove the Kubernetes attributes processor from your configuration. See Kubernetes attributes processor for more information.