Commonly used Prometheus exporters and their recommended ports: Difference between revisions

From Jwiki
No edit summary
No edit summary
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Prometheus Exporter Port Allocation Standard =
This document defines the '''official internal standard''' for Prometheus exporter port assignments within our infrastructure. The primary goal is to create a single, cohesive, and maintainable port scheme that prevents conflicts and is easy to understand and extend.
== Guiding Principles ==
* '''One List, One Standard''': This page is the single source of truth. All services that expose a Prometheus metrics endpoint '''must''' be included in this list with a unique port.
* '''Internal Consistency is Priority''': This list overrides external community standards or vendor defaults if they conflict with our internal, sequential scheme.
* '''Logical Grouping''': Ports are allocated in logical, contiguous blocks, making the scheme predictable and easy to manage.
* '''Documentation First''': Before deploying a new exporter, it '''must''' be added to this list with an assigned port.
----
== Observability & Core Infrastructure (9100-9119) ==
This block covers the foundational layer of our stack, from the observability agent itself to the hosts and orchestration platforms.
{| class="wikitable"
{| class="wikitable"
|+ Core Infrastructure
|-
! Exporter
! Assigned Port
! Notes
|-
| '''Grafana Alloy'''
| `9100`
| For exposing Alloy's '''own internal metrics''' to be scraped by Prometheus. Its separate management UI runs on port `12345`.
|-
| '''Node Exporter'''
| `9101`
| Linux/Unix host metrics.
|-
| '''Windows Exporter'''
| `9102`
| Windows host metrics.
|-
| '''Blackbox Exporter'''
| `9103`
| Probing endpoints (ICMP/HTTP/TCP) for availability.
|-
| '''cAdvisor'''
| `9104`
| Container-level resource usage metrics.
|-
| '''kube-state-metrics'''
| `9105`
| Kubernetes API object state metrics.
|-
| '''Proxmox VE Exporter'''
| `9106`
| Proxmox hypervisor, VM, and container metrics.
|-
| '''eBPF Exporters'''
| `9107`
| For advanced Linux kernel telemetry.
|-
| '''Process Exporter'''
| `9108`
| For detailed metrics on specific Linux processes.
|}
----
== Databases & Caching (9120-9139) ==
Data stores, caches, message queues, and related proxies.
{| class="wikitable"
|+ Databases & Caching
|-
! Exporter
! Exporter
! Recommended Port
! Assigned Port
! Original Default Port
! Notes
! Notes
|-
|-
| Node Exporter
| '''PostgreSQL Exporter'''
| 9100
| `9120`
| 9100
| For PostgreSQL databases.
| Linux/Unix host metrics (universal)
|-
| '''MySQL Exporter'''
| `9121`
| For MySQL and MariaDB databases.
|-
| '''Redis Exporter'''
| `9122`
| For Redis in-memory databases.
|-
|-
| Blackbox Exporter
| '''MongoDB Exporter'''
| 9101
| `9123`
| 9102
| For MongoDB document databases.
| Probing endpoints<br>(ICMP/HTTP/TCP/SSL)
|-
|-
| MySQL Exporter
| '''Elasticsearch Exporter'''
| 9102
| `9124`
| 9101
| For Elasticsearch / OpenSearch clusters.
| MySQL/MariaDB databases
|-
|-
| PostgreSQL Exporter
| '''RabbitMQ Exporter'''
| 9103
| `9125`
| 9105
| For RabbitMQ message brokers.
| PostgreSQL databases
|-
|-
| Redis Exporter
| '''Kafka Exporter'''
| 9104
| `9126`
| 9112
| For Apache Kafka cluster metrics.
| Redis in-memory database
|-
|-
| Windows Exporter
| '''Memcached Exporter'''
| 9105
| `9127`
| 9117
| For Memcached key-value stores.
| Windows hosts
|-
| '''Oracle DB Exporter'''
| `9128`
| For Oracle Database instances.
|-
| '''SQL Exporter'''
| `9129`
| For running generic SQL queries against various databases.
|-
| '''ClickHouse Exporter'''
| `9130`
| For ClickHouse columnar database.
|}
 
----
 
== Applications & Web Services (9140-9159) ==
Web servers, application servers, and specific software platforms.
 
{| class="wikitable"
|+ Applications & Web Services
|-
|-
| MongoDB Exporter
! Exporter
| 9106
! Assigned Port
| 9106
! Notes
| MongoDB databases
|-
|-
| JMX Exporter
| '''JMX Exporter'''
| 9107
| `9140`
| 9107
| For any JVM-based application (e.g., Tomcat, custom Java apps).
| JVM metrics<br>(Kafka, Cassandra, etc.)
|-
|-
| Apache Exporter
| '''Apache Exporter'''
| 9108
| `9141`
| 9117
| For Apache HTTPD servers.
| Apache HTTPD servers
|-
|-
| nginx_exporter
| '''NGINX Exporter'''
| 9109
| `9142`
| 9111
| For NGINX web servers and reverse proxies.
| NGINX web/app servers
|-
|-
| cAdvisor
| '''HAProxy Exporter'''
| 9110
| `9143`
| 8080
| For HAProxy load balancers.
| Container metrics<br>(K8s, Docker hosts)
|-
|-
| kube-state-metrics
| '''PHP-FPM Exporter'''
| 9111
| `9144`
| 8080
| For PHP FastCGI Process Manager.
| Kubernetes resource/object metrics
|-
|-
| Proxmox Exporter
| '''GitLab'''
| 9112
| `9145`
| 9221
| For the main GitLab application metrics.
| Proxmox VE (hypervisor, VM/container/storage metrics)
|-
|-
| GitLab Exporter
| '''GitLab Runner'''
| 9113
| `9146`
| 9168
| For GitLab Runner agents.
| GitLab application
|-
|-
| GitLab Runner Exporter
| '''Consul Exporter'''
| 9114
| `9147`
| 9252
| For HashiCorp Consul service mesh.
| GitLab Runner agents
|-
|-
| RabbitMQ Exporter
| '''Nomad Exporter'''
| 9115
| `9148`
| 9114
| For HashiCorp Nomad cluster orchestrator.
| RabbitMQ messaging
|}
 
----
 
== Networking, Security & Miscellaneous (9160-9189) ==
Exporters for network devices, protocols, security tools, and other utilities.
 
{| class="wikitable"
|+ Networking, Security & Miscellaneous
|-
|-
| Kafka Exporter
! Exporter
| 9116
! Assigned Port
| 9113
! Notes
| Apache Kafka
|-
|-
| Elasticsearch Exporter
| '''SNMP Exporter'''
| 9117
| `9160`
| 9115
| For network gear (switches, routers) and other hardware via SNMP.
| Elasticsearch / OpenSearch
|-
|-
| HAProxy Exporter
| '''Script Exporter'''
| 9118
| `9161`
| 9116
| For wrapping arbitrary shell scripts as a metrics endpoint.
| HAProxy load balancer
|-
|-
| SNMP Exporter
| '''CloudWatch Exporter'''
| 9119
| `9162`
| 9116
| For fetching metrics from AWS CloudWatch.
| Network/legacy equipment (switches/routers)
|-
|-
| Graphite Exporter
| '''Azure Exporter'''
| 9120 (metrics)<br>2003 (ingester)
| `9163`
| 9108 (metrics)<br>9110 (ingester)
| For fetching metrics from Azure Monitor.
| Importing old Graphite metrics
|-
|-
| CloudWatch Exporter
| '''Stackdriver Exporter'''
| 9121
| `9164`
| 9118
| For fetching metrics from Google Cloud Platform.
| AWS metrics
|-
|-
| Azure Exporter
| '''BIND Exporter'''
| 9122
| `9165`
| 9119
| For BIND DNS server metrics.
| Azure cloud metrics
|-
|-
| Stackdriver Exporter
| '''WireGuard Exporter'''
| 9123
| `9166`
| 9120
| For WireGuard VPN tunnel metrics.
| Google Cloud Platform
|-
|-
| PHP-FPM Exporter
| '''OpenVPN Exporter'''
| 9124
| `9167`
| 9121
| For OpenVPN server metrics.
| PHP FastCGI server<br>(WordPress, Magento, etc.)
|-
|-
| rtrtr Exporter
| '''DHCPD Leases Exporter'''
| 9125
| `9168`
| 9108
| For monitoring DHCP server leases.
| (Rare) RPKI/routing
|}
|}
<!--
== Reserved for Future Use (9190-9999) ==
This block is reserved for future allocation. Please update this page before using a port from this range.
-->
[[Category:Prometheus]]
[[Category:Snippets & Notes]]
[[Category:Infrastructure Standard]]

Latest revision as of 16:22, 27 August 2025

Prometheus Exporter Port Allocation Standard

This document defines the official internal standard for Prometheus exporter port assignments within our infrastructure. The primary goal is to create a single, cohesive, and maintainable port scheme that prevents conflicts and is easy to understand and extend.

Guiding Principles

  • One List, One Standard: This page is the single source of truth. All services that expose a Prometheus metrics endpoint must be included in this list with a unique port.
  • Internal Consistency is Priority: This list overrides external community standards or vendor defaults if they conflict with our internal, sequential scheme.
  • Logical Grouping: Ports are allocated in logical, contiguous blocks, making the scheme predictable and easy to manage.
  • Documentation First: Before deploying a new exporter, it must be added to this list with an assigned port.

Observability & Core Infrastructure (9100-9119)

This block covers the foundational layer of our stack, from the observability agent itself to the hosts and orchestration platforms.

Core Infrastructure
Exporter Assigned Port Notes
Grafana Alloy `9100` For exposing Alloy's own internal metrics to be scraped by Prometheus. Its separate management UI runs on port `12345`.
Node Exporter `9101` Linux/Unix host metrics.
Windows Exporter `9102` Windows host metrics.
Blackbox Exporter `9103` Probing endpoints (ICMP/HTTP/TCP) for availability.
cAdvisor `9104` Container-level resource usage metrics.
kube-state-metrics `9105` Kubernetes API object state metrics.
Proxmox VE Exporter `9106` Proxmox hypervisor, VM, and container metrics.
eBPF Exporters `9107` For advanced Linux kernel telemetry.
Process Exporter `9108` For detailed metrics on specific Linux processes.

Databases & Caching (9120-9139)

Data stores, caches, message queues, and related proxies.

Databases & Caching
Exporter Assigned Port Notes
PostgreSQL Exporter `9120` For PostgreSQL databases.
MySQL Exporter `9121` For MySQL and MariaDB databases.
Redis Exporter `9122` For Redis in-memory databases.
MongoDB Exporter `9123` For MongoDB document databases.
Elasticsearch Exporter `9124` For Elasticsearch / OpenSearch clusters.
RabbitMQ Exporter `9125` For RabbitMQ message brokers.
Kafka Exporter `9126` For Apache Kafka cluster metrics.
Memcached Exporter `9127` For Memcached key-value stores.
Oracle DB Exporter `9128` For Oracle Database instances.
SQL Exporter `9129` For running generic SQL queries against various databases.
ClickHouse Exporter `9130` For ClickHouse columnar database.

Applications & Web Services (9140-9159)

Web servers, application servers, and specific software platforms.

Applications & Web Services
Exporter Assigned Port Notes
JMX Exporter `9140` For any JVM-based application (e.g., Tomcat, custom Java apps).
Apache Exporter `9141` For Apache HTTPD servers.
NGINX Exporter `9142` For NGINX web servers and reverse proxies.
HAProxy Exporter `9143` For HAProxy load balancers.
PHP-FPM Exporter `9144` For PHP FastCGI Process Manager.
GitLab `9145` For the main GitLab application metrics.
GitLab Runner `9146` For GitLab Runner agents.
Consul Exporter `9147` For HashiCorp Consul service mesh.
Nomad Exporter `9148` For HashiCorp Nomad cluster orchestrator.

Networking, Security & Miscellaneous (9160-9189)

Exporters for network devices, protocols, security tools, and other utilities.

Networking, Security & Miscellaneous
Exporter Assigned Port Notes
SNMP Exporter `9160` For network gear (switches, routers) and other hardware via SNMP.
Script Exporter `9161` For wrapping arbitrary shell scripts as a metrics endpoint.
CloudWatch Exporter `9162` For fetching metrics from AWS CloudWatch.
Azure Exporter `9163` For fetching metrics from Azure Monitor.
Stackdriver Exporter `9164` For fetching metrics from Google Cloud Platform.
BIND Exporter `9165` For BIND DNS server metrics.
WireGuard Exporter `9166` For WireGuard VPN tunnel metrics.
OpenVPN Exporter `9167` For OpenVPN server metrics.
DHCPD Leases Exporter `9168` For monitoring DHCP server leases.