Prometheus

aid: prometheus-io
url: https://raw.githubusercontent.com/api-evangelist/prometheus-io/refs/heads/main/apis.yml
name: Prometheus
tags:
  - Monitoring
  - Metrics
  - Observability
  - Time Series
  - Alerting
  - Cloud Native
  - CNCF
  - Open Source
  - PromQL
  - Telemetry
description: >-
  Prometheus is a Cloud Native Computing Foundation graduated open source systems monitoring and alerting toolkit. A
  Prometheus server scrapes metrics over HTTP from instrumented targets, stores them in an embedded time series
  database, and lets operators query, alert, and aggregate them with the PromQL query language. The project pairs the
  Prometheus server with Alertmanager for alert routing and silencing, official client libraries for Go, Java, Python,
  Ruby, and Rust, and a large ecosystem of exporters (node, blackbox, snmp, statsd, jmx, mysqld, cloudwatch, consul,
  graphite, memcached, pushgateway, etc.) for pulling metrics out of existing systems. Prometheus also drives the
  OpenMetrics exposition format and an experimental Remote Write 2.0 protocol for shipping samples to long-term storage
  backends.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
kind: contract
access: Self-Hosted
x-type: opensource
created: 2026-05-25T00:00:00.000Z
modified: 2026-05-25T00:00:00.000Z
specificationVersion: '0.20'
apis:
  - aid: prometheus-io:prometheus-server-api
    name: Prometheus Server HTTP API
    tags:
      - Metrics
      - PromQL
      - Query
      - Monitoring
    humanURL: https://prometheus.io/docs/prometheus/latest/querying/api/
    baseURL: http://localhost:9090/api/v1
    description: >-
      The HTTP API exposed by every Prometheus server under /api/v1. Lets clients evaluate instant and range PromQL
      queries, list and search series, labels and metric metadata, inspect targets, scrape pools, rules, active alerts,
      alertmanagers, status, TSDB stats, WAL replay, build/runtime info, server-side notifications, and the live feature
      set. Also includes admin endpoints behind --web.enable-admin-api for snapshots, series deletion, and tombstone
      clean-up, plus optional remote read/write and OTLP metrics receivers. Stable v1 with non-breaking additions;
      experimental endpoints (parse_query, query_exemplars, targets/relabel_steps, status/tsdb/blocks, notifications)
      are clearly marked.
    properties:
      - url: https://prometheus.io/docs/prometheus/latest/querying/api/
        type: Documentation
      - url: https://prometheus.io/docs/prometheus/latest/querying/basics/
        type: Documentation
        name: PromQL Basics
      - url: https://prometheus.io/docs/prometheus/latest/querying/operators/
        type: Documentation
        name: PromQL Operators
      - url: https://prometheus.io/docs/prometheus/latest/querying/functions/
        type: Documentation
        name: PromQL Functions
      - url: openapi/prometheus-server-api-openapi.yml
        type: OpenAPI
      - url: json-schema/prometheus-query-result-schema.json
        type: JSONSchema
      - url: json-schema/prometheus-target-schema.json
        type: JSONSchema
      - url: json-ld/prometheus-io-context.jsonld
        type: JSONLD
      - url: examples/prometheus-query-example.json
        type: Example
      - url: examples/prometheus-query-range-example.json
        type: Example
      - url: examples/prometheus-targets-example.json
        type: Example
  - aid: prometheus-io:prometheus-alertmanager-api
    name: Prometheus Alertmanager API v2
    tags:
      - Alerts
      - Silences
      - Notifications
      - Receivers
      - Cluster
    humanURL: https://github.com/prometheus/alertmanager
    baseURL: http://localhost:9093/api/v2
    description: >-
      Alertmanager's HTTP API v2 — the canonical interface for posting alerts, listing and grouping
      firing/inhibited/silenced alerts, managing silences, listing configured receivers, and inspecting cluster status.
      Spec is generated with go-swagger from api/v2/openapi.yaml in the alertmanager repo and consumed by the
      Alertmanager UI and external integrations.
    properties:
      - url: https://github.com/prometheus/alertmanager/blob/main/api/v2/openapi.yaml
        type: Documentation
      - url: https://prometheus.io/docs/alerting/latest/alertmanager/
        type: Documentation
        name: Alertmanager Overview
      - url: openapi/prometheus-alertmanager-api-openapi.yml
        type: OpenAPI
  - aid: prometheus-io:prometheus-remote-write
    name: Prometheus Remote Write
    tags:
      - Remote Write
      - Ingest
      - Protocol Buffers
      - Streaming
    humanURL: https://prometheus.io/docs/specs/prw/remote_write_spec_2_0/
    description: >-
      Remote Write is Prometheus' push protocol for shipping scraped samples to long-term storage and analysis backends
      (Cortex, Thanos, Mimir, VictoriaMetrics, InfluxDB, Datadog, etc.). Snappy-compressed protocol-buffer payloads
      POSTed over HTTP. Version 1.0 is stable and widely implemented; version 2.0 (experimental specification) adds
      native histograms, metadata-per-series, created timestamps, and tighter validation.
    properties:
      - url: https://prometheus.io/docs/specs/prw/remote_write_spec/
        type: Documentation
        name: Remote Write 1.0 Specification
      - url: https://prometheus.io/docs/specs/prw/remote_write_spec_2_0/
        type: Documentation
        name: Remote Write 2.0 Specification
      - url: https://github.com/prometheus/prometheus/blob/main/prompb/remote.proto
        type: ProtoBuf
        name: remote.proto
  - aid: prometheus-io:prometheus-exposition-format
    name: Prometheus Exposition Format / OpenMetrics
    tags:
      - Exposition
      - OpenMetrics
      - Scraping
      - Metrics Format
    humanURL: https://prometheus.io/docs/instrumenting/exposition_formats/
    description: >-
      The text-based exposition format that every instrumented target exposes (typically on /metrics) and that the
      Prometheus server scrapes over HTTP. The format evolved into OpenMetrics, a CNCF Sandbox specification that is the
      standardized successor; both are scrape-compatible with Prometheus. Defines counters, gauges, histograms,
      summaries, and (in OpenMetrics) info, stateset, gaugehistogram, and exemplars.
    properties:
      - url: https://prometheus.io/docs/instrumenting/exposition_formats/
        type: Documentation
      - url: https://openmetrics.io/
        type: Documentation
        name: OpenMetrics
      - url: https://github.com/prometheus/OpenMetrics
        type: SourceCode
        name: prometheus/OpenMetrics
  - aid: prometheus-io:prometheus-otlp-receiver
    name: Prometheus OTLP Metrics Receiver
    tags:
      - OTLP
      - OpenTelemetry
      - Receiver
      - Ingest
    humanURL: https://prometheus.io/docs/prometheus/latest/feature_flags/
    description: >-
      Optional OpenTelemetry Protocol metrics receiver exposed on /api/v1/otlp/v1/metrics when the Prometheus server is
      started with --web.enable-otlp-receiver. Accepts OTLP/HTTP protobuf payloads from OpenTelemetry Collectors and
      SDKs; delta-to-cumulative conversion is available behind --enable-feature=otlp-deltatocumulative.
    properties:
      - url: https://prometheus.io/docs/guides/opentelemetry/
        type: Documentation
        name: OpenTelemetry Guide
      - url: https://github.com/open-telemetry/opentelemetry-proto
        type: SourceCode
        name: OTLP Protocol Buffers
common:
  - url: https://prometheus.io/
    name: Prometheus Homepage
    type: Portal
  - url: https://prometheus.io/docs/introduction/overview/
    name: Documentation
    type: Documentation
  - url: https://prometheus.io/docs/prometheus/latest/querying/api/
    name: HTTP API Reference
    type: Documentation
  - url: https://github.com/prometheus
    name: Prometheus GitHub Organization
    type: SourceCode
  - url: https://github.com/prometheus/prometheus
    name: prometheus/prometheus
    type: SourceCode
  - url: https://github.com/prometheus/prometheus/releases
    name: Releases
    type: ChangeLog
  - url: https://prometheus.io/download/
    name: Download
    type: Download
  - url: https://prometheus.io/community/
    name: Community
    type: Forum
  - url: https://prometheus.io/docs/introduction/glossary/
    name: Glossary
    type: Documentation
  - url: https://prometheus.io/blog/
    name: Blog
    type: Blog
  - url: https://github.com/cncf/foundation/blob/main/charter.md
    name: CNCF Charter (Governing Body)
    type: TermsOfService
  - url: https://www.cncf.io/projects/prometheus/
    name: CNCF Project Page
    type: Documentation
  - url: https://github.com/prometheus/governance
    name: Project Governance
    type: TermsOfService
  - url: https://github.com/prometheus/prometheus/blob/main/LICENSE
    name: License (Apache 2.0)
    type: License
  - url: https://github.com/prometheus/prometheus/security/policy
    name: Security Policy
    type: Security
  - url: https://github.com/prometheus/prometheus/blob/main/CHANGELOG.md
    name: Changelog
    type: ChangeLog
  - url: https://github.com/prometheus/client_golang
    name: Go Client Library
    type: SDK
  - url: https://github.com/prometheus/client_python
    name: Python Client Library
    type: SDK
  - url: https://github.com/prometheus/client_java
    name: Java Client Library
    type: SDK
  - url: https://github.com/prometheus/client_ruby
    name: Ruby Client Library
    type: SDK
  - url: https://github.com/prometheus/client_rust
    name: Rust Client Library
    type: SDK
  - url: https://github.com/siimon/prom-client
    name: Node.js Client Library (community)
    type: SDK
  - url: https://github.com/jupp0r/prometheus-cpp
    name: C++ Client Library (community)
    type: SDK
  - url: https://github.com/prometheus/alertmanager
    name: Alertmanager
    type: Tools
  - url: https://github.com/prometheus/node_exporter
    name: node_exporter
    type: Tools
  - url: https://github.com/prometheus/blackbox_exporter
    name: blackbox_exporter
    type: Tools
  - url: https://github.com/prometheus/snmp_exporter
    name: snmp_exporter
    type: Tools
  - url: https://github.com/prometheus/statsd_exporter
    name: statsd_exporter
    type: Tools
  - url: https://github.com/prometheus/jmx_exporter
    name: jmx_exporter
    type: Tools
  - url: https://github.com/prometheus/mysqld_exporter
    name: mysqld_exporter
    type: Tools
  - url: https://github.com/prometheus/cloudwatch_exporter
    name: cloudwatch_exporter
    type: Tools
  - url: https://github.com/prometheus/pushgateway
    name: Pushgateway
    type: Tools
  - url: https://github.com/prometheus/promlens
    name: PromLens (PromQL builder)
    type: Tools
  - url: https://github.com/prometheus/prom2json
    name: prom2json
    type: Tools
  - url: https://github.com/prometheus/OpenMetrics
    name: OpenMetrics Specification
    type: Documentation
  - url: https://github.com/prometheus/proposals
    name: Design Proposals
    type: Documentation
  - url: https://prometheus.io/docs/prometheus/latest/installation/
    name: Installation
    type: Documentation
  - url: https://hub.docker.com/r/prom/prometheus
    name: Docker Image
    type: ContainerImage
  - url: https://www.linkedin.com/company/cloud-native-computing-foundation/
    name: CNCF LinkedIn
    type: LinkedIn
  - url: https://twitter.com/PrometheusIO
    name: Twitter / X
    type: Twitter
include: []
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com