Documentation forAppOptics

Custom Metrics

Custom Metrics allow you to send any type of metric to AppOptics, be it the number of users who’ve performed an action, the timing of a code block, or the temperature of your datacenter racks. There’s a number of ways to submit them as well: via language bindings, open source collection agents or even a simple curl command with an HTTP POST.

If you are getting started with AppOptics and do not want to install the Host Agent or any APM language agents you can skip the onboarding and go directly to the API tokens page to start collecting custom metrics right from the welcome page:


In this section you will find:

Collecting metrics

There's a number of ways to collect metrics in AppOptics:

Method Collector When to use
Statsd collector plugin Host agent Drop-in for existing statsd metric collection, extensible for arbitrary metrics.
Custom metrics SDK APM agents Custom metrics reported from an APM agent can automatically be associated with the service in question and associated attributes; lower overhead than statsd, though either or both can be used without issue.
Full-featured API REST API Metric CRUD as well as full capabilities around dashboards, alerts. Use to create deeper integrations beyond just metric publishing. Client libraries available.
Prometheus, Fluentd, and other plugins Host agent Drop-in for standard and custom metric collection.

Host agent - statsd and other plugins

The most common way to collect metrics is by installing the AppOptics Host Agent. The agent provides system metrics out of the box and has a very flexible plugin architecture that allows you to install plugins for particular use cases. Among the most common is statsd support. For some plugins we have created Integrations where we carefully select the most important metrics and curate dashboards on your behalf. For many other uses cases you can use community contributed plugins to collect relevant metrics and start building custom dashboards.

APM custom metrics SDK

The APM agents ship with a custom metrics SDK that’s the easiest and most performant way to log metrics from within an APM-instrumented application.


If you prefer to create your own collector or use basic scripts, simply create a token and POST metrics to our RESTful API. You can find existing tokens or create new ones in your Organization Settings under the API Tokens sub-menu.

Server-side data processing

Data processing is the ability to manipulate data after we received it via our API. You can use Composite Metrics to apply mathematical transforms to any combination of your time series. Service-Side Aggregation (SSA) allows you to aggregate multiple measurements sent to the AppOptics API into a single complex gauge measurement.

Navigation Notice: When the APM Integrated Experience is enabled, AppOptics shares a common navigation and enhanced feature set with other integrated experience products. How you navigate AppOptics and access its features may vary from these instructions.