API V1
  • Global information
  • Authentication
  • Data format
  • Rate Limit
  • Errors
  • Pagination
RESOURCES
  • Addon providers
  • Addons
  • Alerts
  • Applications
  • Audit Logs
  • Autoscalers
  • Billing
  • Collaborators
  • Container Sizes
  • Cron Tasks
  • Data Access Consents
  • Databases
  • Deployment
  • Domains
  • Environment variables
  • Event Categories
  • Event Types
  • Events
  • Invoices
  • SSH Keys
  • Log Drains
  • Application Logs
  • Metrics
    • Get Application Metrics
    • List the Metrics Available
  • Notification Platforms
  • Notifiers
  • One-off Containers
  • Operations
  • Projects
  • Referral
  • Regions
  • SCM Integrations
  • Integration Link
  • Sources
  • Stacks
  • Tokens
  • User Account
LINKS
  • Addon Provider API
  • Database API
  • One-click Deployment API
  • scalingo.json Schema
  • Main site
  • Dashboard

Metrics

Metric attributes

field type description
id string unique identifier
label string human readable string explaining this metric
suffix string symbol used as a suffix after this metric value
type string type of metric. Can be either global or router

Example object:

{
  "id": "cpu",
  "label": "CPU",
  "suffix": "%",
  "type": "global"
}

Get Application Metrics

The endpoint to get an application metrics is described here.

List the Metrics Available

This endpoint can be reached unauthenticated.

GET https://$SCALINGO_API_URL/v1/features/metrics

List all the metrics available on the platform. These metrics are useful with the alert and the autoscaling features.

Example Request

curl -H "Accept: application/json" -H "Content-Type: application/json" \
  -X GET https://$SCALINGO_API_URL/v1/features/metrics

Returns 200 OK

{
  "metrics": [
    {
      "id": "cpu",
      "label": "CPU",
      "suffix": "%",
      "type": "global"
    },
    {
      "id": "memory",
      "label": "RAM",
      "suffix": "%",
      "type": "global"
    },
    {
      "id": "swap",
      "label": "Swap",
      "suffix": "%",
      "type": "global"
    },
    {
      "id": "p95_response_time",
      "label": "Response Time",
      "suffix": "ms",
      "type": "router"
    },
    {
      "id": "5XX",
      "label": "5xx Errors",
      "suffix": "",
      "type": "router"
    },
    {
      "id": "all",
      "label": "Requests per Minute",
      "suffix": "rpm",
      "type": "router"
    },
    {
      "id": "rpm_per_container",
      "label": "RPM per Container",
      "suffix": "rpm",
      "type": "router"
    }
  ]
}