aprs.me/lib/aprsme_web/telemetry.ex

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(),
             # Default buckets for distribution metrics
             buckets: [
               0.01,
               0.025,
               0.05,
               0.1,
               0.25,
               0.5,
               1,
               2.5,
               5,
               10,
               25,
               50,
               100,
               250,
               500,
               1000,
               2500,
               5000,
               10_000
             ]
           ]}
        ]
      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}
      ),
      distribution("phoenix.endpoint.stop.duration",
        unit: {:native, :millisecond}
      ),
      distribution("phoenix.router_dispatch.start.system_time",
        tags: [:route],
        unit: {:native, :millisecond}
      ),
      distribution("phoenix.router_dispatch.exception.duration",
        tags: [:route],
        unit: {:native, :millisecond}
      ),
      distribution("phoenix.router_dispatch.stop.duration",
        tags: [:route],
        unit: {:native, :millisecond}
      ),
      distribution("phoenix.socket_connected.duration",
        unit: {:native, :millisecond}
      ),
      distribution("phoenix.channel_join.duration",
        unit: {:native, :millisecond}
      ),
      distribution("phoenix.channel_handled_in.duration",
        tags: [:event],
        unit: {:native, :millisecond}
      ),

      # Database Metrics - Use distribution for query times
      distribution("aprsme.repo.query.total_time",
        unit: {:native, :millisecond},
        description: "The sum of the other measurements"
      ),
      distribution("aprsme.repo.query.decode_time",
        unit: {:native, :millisecond},
        description: "The time spent decoding the data received from the database"
      ),
      distribution("aprsme.repo.query.query_time",
        unit: {:native, :millisecond},
        description: "The time spent executing the query"
      ),
      distribution("aprsme.repo.query.queue_time",
        unit: {:native, :millisecond},
        description: "The time spent waiting for a database connection"
      ),
      distribution("aprsme.repo.query.idle_time",
        unit: {:native, :millisecond},
        description: "The time the connection spent waiting before being checked out for the query"
      ),

      # 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)"
      ),

      # 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