Aptible PaaS logoDocs

Datadog Metric Drain

Aptible can deliver your metrics to a Datadog account. This may be useful if you are using Datadog for application performance monitoring and would like to pull in metrics from Aptible to compare.

Datadog Metrics Structure

Aptible metrics are reported as Custom Metrics in Datadog. The following metrics are reported (all these metrics are reported as gauge in Datadog, approximately every 30 seconds):

  • enclave.running: a boolean indicating whether the Container was running when this point was sampled.
  • enclave.milli_cpu_usage: the Container's average CPU usage (in milli CPUs) over the reporting period.
  • enclave.milli_cpu_limit: the maximum CPU accessible to the container. If CPU Isolation is disabled, this metric will return 0.
  • enclave.memory_total_mb: the Container's total memory usage. See Understanding Memory Utilization for more information on memory usage.
  • enclave.memory_rss_mb: the Container's RSS memory usage. This memory is typically not reclaimable. If this exceeds the memory_limit_mb, the container will be restarted.
  • enclave.memory_limit_mb: the Container's Memory Limit.
  • enclave.disk_read_kbps: the Container's average disk read bandwidth over the reporting period.
  • enclave.disk_write_kbps: the Container's average disk write bandwidth over the reporting period.
  • enclave.disk_read_iops: the Container's average disk read IOPS over the reporting period.
  • enclave.disk_write_iops: the Container's average disk write IOPS over the reporting period.
  • enclave.disk_usage_mb: the Database's Disk usage (Database metrics only).
  • enclave.disk_limit_mb: the Database's Disk size (Database metrics only).
  • enclave.pids_current: the current number of tasks in the Container (see Other Limits).
  • enclave.pids_limit: the maximum number of tasks for the Container (see Other Limits).
📘 Review Understanding Memory Utilization for more information on the meaning of the enclave.memory_total_mb and enclave.memory_rss_mb values.
📘 Review I/O Performance for more information on the meaning of the enclave.disk_read_iops and enclave.disk_write_iops values.

All metrics published in Datadog are enriched with the following tags:

  • environment: Environment handle
  • app: App handle (App metrics only)
  • database: Database handle (Database metrics only)
  • service: Service name
  • container: Container ID

Finally, Aptible also sets the host on these metrics to the Container Hostname (Short Container ID).

Datadog Metric Drain