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-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
kind: contract
access: Self-Hosted
x-type: opensource
created: 2026-05-25
modified: 2026-05-25
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
  - type: NaftikoCapability
    url: capabilities/prometheus-query.yaml
  - type: NaftikoCapability
    url: capabilities/prometheus-metadata.yaml
  - type: NaftikoCapability
    url: capabilities/prometheus-targets.yaml
  - type: NaftikoCapability
    url: capabilities/prometheus-rules-alerts.yaml
  - type: NaftikoCapability
    url: capabilities/prometheus-status.yaml
  - type: NaftikoCapability
    url: capabilities/prometheus-admin-tsdb.yaml
- 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
  - type: NaftikoCapability
    url: capabilities/prometheus-alertmanager.yaml
- 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: [email protected]