Prometheus

Prometheus is a platform for scraping metrics from services and utilities. You can use @graphql-mesh/plugin-prometheus plugin to expose and collect metrics from all phases of your GraphQL execution including internal query planning and outgoing HTTP requests.

This plugin tracks the complete gateway execution flow and exposes the following metrics:

• Successful requests (requestCount)
• Request summary (requestSummary)
• errors (categorized by phase)
• resolvers tracing and runtime
• deprecated fields usage
• count of graphql operations
• parse execution time
• validate execution time
• contextBuilding execution time
• execute execution time
• Latency of outgoing HTTP request
• Latency of the delegation to the individual sources

Getting Started

npm i @graphql-mesh/plugin-prometheus prom-client

Example Configuration

# ...
plugins:
  - prometheus:
    # all optional, and by default, all set to false, please opt-in to the metrics you wish to get
 
    # requires `execute` to be true
    requestCount: true
    # requires `execute` to be true
    requestSummary: true
    parse: true
    validate: true
    contextBuilding: true
    execute: true
    errors: true
    resolvers: true
 
    # reports metrics for the delegation to the individual sources
    delegation: true
 
    # reports metrics for the outgoing HTTP requests
    fetch: true
    # Adds the request headers to the metrics
    fetchRequestHeaders: true
    # Adds the response headers to the metrics
    fetchResponseHeaders: true
 
    # reports metrics for the incoming HTTP requests (this sets a custom name for http)
    # If you pass a string instead of boolean, it will be used as the name of the metric
    http: my-http-duration-metric
    # Adds the request headers to the metrics
    httpRequestHeaders: true
    # Adds the response headers to the metrics
    httpResponseHeaders: true
 
    # reports metrics also for these resolvers, by default all fields are reported
    resolversWhiteList:
      - Mutation.*
      - Query.user
    deprecatedFields: true
    # the path of the endpoint to expose the metrics, default is /metrics
    endpoint: /metrics

Note: Tracing resolvers using resolvers: true might have a performance impact on your GraphQL runtime. Please consider to test it locally first and then decide if it's needed.

Custom Registry

You can customize the client's registry by passing a custom registry to the registry option.

// myRegistry.ts
import { Registry } from 'prom-client';
 
export default const myRegistry = new Registry();

# ...
plugins:
  - prometheus:
      # ...
      registry: ./myRegistry.ts

Config API Reference

• requestCount - One of:
  • Boolean
  • String
• requestTotalDuration - One of:
  • Boolean
  • String
• requestSummary - One of:
  • Boolean
  • String
• parse - One of:
  • Boolean
  • String
• validate - One of:
  • Boolean
  • String
• contextBuilding - One of:
  • Boolean
  • String
• execute - One of:
  • Boolean
  • String
• errors - One of:
  • Boolean
  • String
• deprecatedFields - One of:
  • Boolean
  • String
• skipIntrospection (type: Boolean)
• registry (type: String)
• delegation - One of:
  • Boolean
  • String
• fetch - One of:
  • Boolean
  • String
• fetchRequestHeaders (type: Boolean)
• fetchResponseHeaders (type: Boolean)
• http - One of:
  • Boolean
  • String
• httpRequestHeaders (type: Boolean)
• httpResponseHeaders (type: Boolean)
• endpoint (type: String) - The path to the metrics endpoint default: /metrics