Aptible can deliver your Metrics to any InfluxDB Database (hosted on Aptible or not). There are two types of InfluxDB Metric Drains on Aptible:

  • Aptible-hosted: This method allows you to route metrics to an InfluxDB Database hosted on Aptible. This Database must live in the same Environment as the Metrics you are retrieving. Additionally, the Aptible Metrics Terraform Module uses this method to deploy prebuilt Grafana dashboards with alerts for monitoring RAM & CPU usage for your Apps & Databases - so you can instantly start monitoring your Aptible resources.
  • Hosted anywhere: This method allows you to route Metrics to any InfluxDB. This might be useful if you are leveraging InfluxData’s hosted InfluxDB offering.

​
InfluxDB Metrics Structure

Aptible InfluxDB Metric Drains publish metrics in a series named metrics.

The following values are published (approximately every 30 seconds):

  • running: a boolean indicating whether the Container was running when this point was sampled.
  • milli_cpu_usage: the Container’s average CPU usage (in milli CPUs) over the reporting period.
  • milli_cpu_limit: the maximum CPU accessible to the container.
  • memory_total_mb: the Container’s total memory usage.
  • 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.
  • memory_limit_mb: the Container’s Memory Limit.
  • disk_read_kbps: the Container’s average disk read bandwidth over the reporting period.
  • disk_write_kbps: the Container’s average disk write bandwidth over the reporting period.
  • disk_read_iops: the Container’s average disk read IOPS over the reporting period.
  • disk_write_iops: the Container’s average disk write IOPS over the reporting period.
  • disk_usage_mb: the Database’s Disk usage (Database metrics only).
  • disk_limit_mb: the Database’s Disk size (Database metrics only).
  • pids_current: the current number of tasks in the Container (see Other Limits).
  • 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 memory_total_mb and memory_rss_mb values.

📘 Review I/O Performance for more information on the meaning of the disk_read_iops and disk_write_iops values.

All points are enriched with the following tags:

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

​
Getting Started