November 27, 2024

@graphql-yoga/[email protected]

Minor Changes

• #3458
  cb29c6c
  Thanks @kroupacz! - ### Removed
  • Breaking change remove option to set clientName and clientVersion as a static string
    in ApolloUsageReportOptions

Patch Changes

• #3488
  a4bc07f
  Thanks @kroupacz! - fixed: move logic from onEnveloped hook to
  onParse hook (onParseEnd) which prevents the operationName could be missing.

@graphql-yoga/[email protected]

Minor Changes

• #3489
  131dfa3
  Thanks @EmrysMyrddin! - Allow to explicitly control which
  events and timing should be observe.

  Each metric can now be configured to observe events and timings only for certain GraphQL pipeline
  phases, or depending on the request context.

  Example: trace only execution and subscription errors

  import { execute, parse, specifiedRules, subscribe, validate } from 'graphql'
  import { envelop, useEngine } from '@envelop/core'
  import { usePrometheus } from '@envelop/prometheus'
  
  const TRACKED_OPERATION_NAMES = [
    // make a list of operation that you want to monitor
  ]
  
  const getEnveloped = envelop({
    plugins: [
      useEngine({ parse, validate, specifiedRules, execute, subscribe }),
      usePrometheus({
        metrics: {
          // Here, an array of phases can be provided to enable the metric only on certain phases.
          // In this example, only error happening during the execute and subscribe phases will tracked
          graphql_envelop_phase_error: ['execute', 'subscribe']
        }
      })
    ]
  })

  Example: Monitor timing only of a set of operations by name

  import { execute, parse, specifiedRules, subscribe, validate } from 'graphql'
  import { envelop, useEngine } from '@envelop/core'
  import { usePrometheus } from '@envelop/prometheus'
  
  const TRACKED_OPERATION_NAMES = [
    // make a list of operation that you want to monitor
  ]
  
  const getEnveloped = envelop({
    plugins: [
      useEngine({ parse, validate, specifiedRules, execute, subscribe }),
      usePrometheus({
        metrics: {
          graphql_yoga_http_duration: createHistogram({
            registry,
            histogram: {
              name: 'graphql_envelop_request_duration',
              help: 'Time spent on HTTP connection',
              labelNames: ['operationName']
            },
            fillLabelsFn: ({ operationName }, _rawContext) => ({ operationName }),
            phases: ['execute', 'subscribe'],
  
            // Here `shouldObserve` control if the request timing should be observed, based on context
            shouldObserve: ({ operationName }) => TRACKED_OPERATIONS.includes(operationName)
          })
        }
      })
    ]
  })

  Default Behavior Change

  A metric is enabled using true value in metrics options will observe in every phases available.

  Previously, which phase was observe was depending on which other metric were enabled. For example,
  this config would only trace validation error:

  usePrometheus({
    metrics: {
      graphql_envelop_phase_error: true,
      graphql_envelop_phase_validate: true
    }
  })

  This is no longer the case. If you were relying on this behavior, please use an array of string to
  restrict observed phases.

  usePrometheus({
    metrics: {
      graphql_envelop_phase_error: ['validate']
    }
  })

  Deprecation

  The fillLabelFn function was provided the response and request through the context
  argument.

  This is now deprecated, request and response are now available in the first params argument.
  This change allows to provide better typing, since context is not typed.

Patch Changes

• #3489
  131dfa3
  Thanks @EmrysMyrddin! - dependencies updates:

  • Updated dependency
    @envelop/prometheus@11.1.0-alpha-20241122091727-adade563355e3d213f27427a9a1d86adf9431d41 ↗︎
    (from 11.0.0, in dependencies)

• #3519
  ca1e8b4
  Thanks @EmrysMyrddin! - dependencies updates:

  • Updated dependency
    @envelop/[email protected] ↗︎
    (from 11.1.0-alpha-20241122091727-adade563355e3d213f27427a9a1d86adf9431d41, in dependencies)