aprs.me/lib/aprsme_web/telemetry.ex
Graham McIntire 5f783894a4
Add PostgreSQL and database pool metrics to telemetry
- Create DatabaseMetrics module to collect PostgreSQL statistics
- Add metrics for database connection pool (size, idle, busy, queue)
- Add PostgreSQL connection metrics (active, idle, waiting)
- Add packets table metrics (size, row counts, operations)
- Add query performance metrics from pg_stat_statements
- Create enhanced Grafana dashboard with database visualizations
- Configure periodic measurements to collect metrics every 10 seconds

This provides comprehensive database monitoring including:
- Connection pool health and utilization
- PostgreSQL connection states and bottlenecks
- Table growth and dead tuple ratios
- Query performance statistics
- Database and table sizes

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-27 14:13:17 -05:00

197 lines
8.9 KiB
Elixir

defmodule AprsmeWeb.Telemetry do
@moduledoc false
use Supervisor
import Telemetry.Metrics
alias Aprsme.Telemetry.DatabaseMetrics
def start_link(arg) do
Supervisor.start_link(__MODULE__, arg, name: __MODULE__)
end
@impl true
def init(_arg) do
children =
if Application.get_env(:aprsme, AprsmeWeb.Telemetry)[:enabled] == false do
[
# Only telemetry poller in test mode
{:telemetry_poller, measurements: periodic_measurements(), period: 10_000}
]
# Telemetry poller will execute the given period measurements
# every 10_000ms. Learn more here: https://hexdocs.pm/telemetry_metrics
else
[
{:telemetry_poller, measurements: periodic_measurements(), period: 10_000},
# Add reporters as children of your supervision tree.
# {Telemetry.Metrics.ConsoleReporter, metrics: metrics()}
{TelemetryMetricsPrometheus, [metrics: metrics()]}
]
end
Supervisor.init(children, strategy: :one_for_one)
end
def metrics do
[
# Phoenix Metrics - Use distribution for latency measurements
distribution("phoenix.endpoint.start.system_time",
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("phoenix.endpoint.stop.duration",
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("phoenix.router_dispatch.start.system_time",
tags: [:route],
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("phoenix.router_dispatch.exception.duration",
tags: [:route],
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("phoenix.router_dispatch.stop.duration",
tags: [:route],
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("phoenix.socket_connected.duration",
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("phoenix.channel_join.duration",
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("phoenix.channel_handled_in.duration",
tags: [:event],
unit: {:native, :millisecond},
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
# Database Metrics - Use distribution for query times
distribution("aprsme.repo.query.total_time",
unit: {:native, :millisecond},
description: "The sum of the other measurements",
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("aprsme.repo.query.decode_time",
unit: {:native, :millisecond},
description: "The time spent decoding the data received from the database",
buckets: [1, 5, 10, 25, 50, 100, 250, 500, 1000]
),
distribution("aprsme.repo.query.query_time",
unit: {:native, :millisecond},
description: "The time spent executing the query",
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
distribution("aprsme.repo.query.queue_time",
unit: {:native, :millisecond},
description: "The time spent waiting for a database connection",
buckets: [1, 5, 10, 25, 50, 100, 250, 500, 1000]
),
distribution("aprsme.repo.query.idle_time",
unit: {:native, :millisecond},
description: "The time the connection spent waiting before being checked out for the query",
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
# VM Metrics - Use last_value for current state
last_value("vm.memory.total", unit: {:byte, :kilobyte}),
last_value("vm.total_run_queue_lengths.total"),
last_value("vm.total_run_queue_lengths.cpu"),
last_value("vm.total_run_queue_lengths.io"),
# GenStage Packet Pipeline Metrics - Use counter and distribution
counter("aprsme.packet_pipeline.batch.count", unit: :event, description: "Total number of packets processed"),
counter("aprsme.packet_pipeline.batch.success",
unit: :event,
description: "Total number of successful inserts"
),
counter("aprsme.packet_pipeline.batch.error", unit: :event, description: "Total number of errors"),
distribution("aprsme.packet_pipeline.batch.duration_ms",
unit: :millisecond,
description: "Batch insert duration (ms)",
buckets: [10, 50, 100, 250, 500, 1000, 2500, 5000, 10_000]
),
# Note: SystemMonitor and InsertOptimizer metrics removed after reverting performance optimizations
# Spatial PubSub Metrics
last_value("aprsme.spatial_pubsub.clients.count", description: "Number of connected clients"),
last_value("aprsme.spatial_pubsub.clients.grid_cells", description: "Number of active grid cells"),
last_value("aprsme.spatial_pubsub.clients.avg_clients_per_cell", description: "Average clients per grid cell"),
counter("aprsme.spatial_pubsub.broadcasts.total", description: "Total spatial broadcasts sent"),
counter("aprsme.spatial_pubsub.broadcasts.filtered", description: "Broadcasts filtered by viewport"),
counter("aprsme.spatial_pubsub.broadcasts.packets", description: "Total packets processed"),
last_value("aprsme.spatial_pubsub.efficiency.ratio", unit: :percent, description: "Broadcast efficiency ratio"),
counter("aprsme.spatial_pubsub.efficiency.saved_broadcasts",
description: "Number of broadcasts saved by filtering"
),
# Database Connection Pool Metrics
last_value("aprsme.repo.pool.size", description: "Configured pool size"),
last_value("aprsme.repo.pool.idle", description: "Number of idle connections"),
last_value("aprsme.repo.pool.busy", description: "Number of busy connections"),
last_value("aprsme.repo.pool.available", description: "Number of available connections"),
last_value("aprsme.repo.pool.queue_length", description: "Number of processes waiting for a connection"),
last_value("aprsme.repo.pool.total", description: "Total connections in pool"),
# PostgreSQL Database Metrics
last_value("aprsme.postgres.database.size_bytes", unit: {:byte, :megabyte}, description: "Database size"),
last_value("aprsme.postgres.connections.total", description: "Total database connections"),
last_value("aprsme.postgres.connections.active", description: "Active database connections"),
last_value("aprsme.postgres.connections.idle", description: "Idle database connections"),
last_value("aprsme.postgres.connections.idle_in_transaction", description: "Idle in transaction connections"),
last_value("aprsme.postgres.connections.waiting", description: "Connections waiting on locks"),
# Packets Table Metrics
last_value("aprsme.postgres.packets_table.live_tuples", description: "Number of live rows in packets table"),
last_value("aprsme.postgres.packets_table.dead_tuples", description: "Number of dead rows in packets table"),
counter("aprsme.postgres.packets_table.total_inserts", description: "Total inserts to packets table"),
counter("aprsme.postgres.packets_table.total_updates", description: "Total updates to packets table"),
counter("aprsme.postgres.packets_table.total_deletes", description: "Total deletes from packets table"),
last_value("aprsme.postgres.packets_table.table_size_bytes",
unit: {:byte, :megabyte},
description: "Packets table size"
),
last_value("aprsme.postgres.packets_table.indexes_size_bytes",
unit: {:byte, :megabyte},
description: "Packets indexes size"
),
# Query Performance Metrics
counter("aprsme.postgres.query_stats.total_calls", description: "Total number of queries executed"),
last_value("aprsme.postgres.query_stats.total_time_ms",
unit: :millisecond,
description: "Total query execution time"
),
last_value("aprsme.postgres.query_stats.avg_time_ms",
unit: :millisecond,
description: "Average query execution time"
),
last_value("aprsme.postgres.query_stats.max_time_ms",
unit: :millisecond,
description: "Maximum query execution time"
),
# Replication Metrics (if applicable)
last_value("aprsme.postgres.replication.lag_seconds", unit: :second, description: "Replication lag in seconds")
]
end
defp periodic_measurements do
[
# A module, function and arguments to be invoked periodically.
# This function must call :telemetry.execute/3 and a metric must be added above.
# {AprsmeWeb, :count_users, []}
{DatabaseMetrics, :collect_db_pool_metrics, []},
{DatabaseMetrics, :collect_postgres_metrics, []},
{DatabaseMetrics, :collect_pgbouncer_metrics, []}
]
end
end