|
对于最新的稳定版本，请使用Spring GraphQL 2.0.2！ |
可观测性
Observability support with Micrometer 是直接集成在 Spring for GraphQL 中的。这使得您可以为 GraphQL 请求和“非平凡”的数据获取操作获得指标和跟踪。 由于 GraphQL 引擎是基于传输层运行的，因此如果您使用的 Spring 框架支持该传输层观察，则还应 期望从传输层得到观察。
观察结果仅在应用程序中配置了ObservationRegistry时发布。
您可以在Spring Boot 中了解有关配置可观测性基础设施的更多信息。
如果您希望自定义与GraphQL观测结果一起生成的元数据，可以直接在仪器化上配置一个自定义惯例。如果您的应用程序使用了Spring Boot，则将自定义惯例作为bean贡献是首选方式。
服务器请求监控
GraphQL Server Requests 观测是在传统和Reactive应用程序以及所有支持的传输方式中以名称 "graphql.request" 创建的。
这种仪表假设任何父观测必须在GraphQL上下文中使用广为人知的 "micrometer.observation" 键设置为当前观测。
对于跨网络边界跟踪传播，需要在传输级别进行单独的跟踪传播仪表。
在HTTP情况下，Spring Framework 提供专门用于处理跟踪传播的仪表。
应用程序需要在应用中配置org.springframework.graphql.observation.GraphQlObservationInstrumentation的监控。
它默认使用org.springframework.graphql.observation.DefaultExecutionRequestObservationConvention，由ExecutionRequestObservationContext支持。
默认情况下，以下KeyValues会被创建：
姓名 |
描述 |
|
GraphQL 操作名称。 |
|
GraphQL请求的结果。 |
graphql.operation键值将使用提供的查询的自定义名称，或者如果没有提供，则使用操作的标准名称。（"query"、"mutation" 或 "subscription"）。
graphql.outcome键值将是:
-
"SUCCESS"如果有效GraphQL响应已被发送且不包含任何错误 -
"REQUEST_ERROR"如果请求无法解析，或者响应包含错误（其中 none 不存在类型为org.springframework.graphql.execution.ErrorType.INTERNAL_ERROR的错误） -
"INTERNAL_ERROR"如果无法生成有效的GraphQL响应，或响应中包含至少一个类型为org.springframework.graphql.execution.ErrorType.INTERNAL_ERROR的错误，则返回此值。
姓名 |
描述 |
|
|
Spring for GraphQL 还贡献了事件用于服务器请求观察。 Micrometer 观察事件通常作为跟踪中的跨度注解进行处理。 这些 instrumentation 记录了 GraphQL 响应中列出的错误作为事件。
姓名 |
上下文名称 |
GraphQL错误类型，例如 |
的完整GraphQL错误消息，例如 |
DataFetcher 插桩
GraphQL DataFetcher 观察点是以名称 "graphql.datafetcher" 创建的，仅用于被视为“非平凡”的数据获取操作（对 Java 对象属性的获取是一个平凡的操作）。
应用程序需要在应用中配置 org.springframework.graphql.observation.GraphQlObservationInstrumentation 仪器化。
它默认使用 org.springframework.graphql.observation.DefaultDataFetcherObservationConvention，由 DataFetcherObservationContext 支持。
默认情况下，以下KeyValues会被创建：
姓名 |
描述 |
|
数据获取错误的类名 |
|
取回字段的名称。 |
|
GraphQL数据获取操作的结果，"SUCCESS" 或 "ERROR"。 |
姓名 |
描述 |
|
路径到正在获取的字段（例如，“/bookById”）。 |