Skip to main content

Grafana + AWS CloudWatch

The SocketX Grafana dashboard queries CloudWatch Logs Insights — it requires your SocketX containers' logs to be in a CloudWatch log group, which the AWS deployment variants do out of the box (awslogs log driver). It works with both v1 and v2 servers.

Download​

Import​

  1. In Grafana (or Amazon Managed Grafana), go to Dashboards → New → Import.
  2. Upload the dashboard JSON.
  3. When prompted, select your CloudWatch data source, the AWS region, and the log group your SocketX containers write to (the $datasource, $region, and $loggroup template variables).

Amazon Managed Grafana needs the CloudWatch data source configured with an IAM role that can run Logs Insights queries against the SocketX log group. For full AWS setup (Amazon Managed Grafana + CloudWatch), see the AWS deployment guide.

Panels​

  • Global Health — total connections, total MTE operations, total bytes processed, average encrypt/decrypt time, average session duration.
  • Connection Metrics — new connections over time, session duration (avg/max/min).
  • MTE Performance — encryption and decryption latency (avg/p95/p99), operation counts over time.
  • Traffic & Throughput — bytes processed over time, payload size statistics, messages and bytes by direction.
  • Session Audit — recent session audits and recent MTE/recovery events.
Sampling and counts

If MTE_EVENT_SAMPLE_RATE (v2) is below 1.0, panels computed from per-message MTE events show the sampled fraction. Panels computed from the close-time audit object (messages/bytes by direction, session duration) remain exact.