JD.AI Gateway Observability

• Type: observability
• Kind: ObservabilityIndex
• ID: observability.jdai-gateway
• Status: draft
• Source: specs/observability/examples/observability.example.yaml

YAML

apiVersion: jdai.upss/v1
kind: Observability
id: observability.jdai-gateway
version: 1
status: draft
metadata:
  owners:
    - JerrettDavis
  reviewers:
    - upss-observability-agent
  lastReviewed: 2026-03-07
  changeReason: Establish the first canonical observability specification for the JD.AI gateway service.
serviceRefs:
  - jdai-gateway
metrics:
  - name: gateway_requests_total
    type: counter
    description: Total number of requests processed by the gateway.
logs:
  - name: gateway_request_log
    level: info
    format: "method={method} path={path} status={status} duration={duration_ms}ms"
traces:
  - name: gateway_inbound_request
    spanKind: server
    attributes:
      - http.method
      - http.route
      - http.status_code
alerts:
  - name: gateway_high_error_rate
    condition: rate(gateway_requests_total{status=~"5.."}[5m]) > 0.05
    severity: critical
trace:
  upstream:
    - specs/vision/examples/vision.example.yaml
  downstream:
    operations:
      - tests/JD.AI.Tests/Specifications/ObservabilitySpecificationRepositoryTests.cs
    governance:
      - src/JD.AI.Core/Specifications/ObservabilitySpecification.cs