Megosztás a következőn keresztül:

Nyitott telemetriai és tevékenységkövetések használata

A Data API Builder (DAB) támogatja az OpenTelemetryt az elosztott nyomkövetéshez és metrikákhoz, lehetővé téve az alkalmazás viselkedésének monitorozását és diagnosztizálását a REST, a GraphQL, az adatbázis-műveletek és a belső köztes szoftverek között.

Data API builder Traces

A DAB az OpenTelemetria "tevékenységeit" hozza létre a következőhöz:

  • Bejövő HTTP-kérések (REST-végpontok)
  • GraphQL operations
  • Database queries (per entity)
  • Belső köztes szoftver lépései (pl. kéréskezelés, hibakövetés)

Minden tevékenység részletes címkéket (metaadatokat) tartalmaz, például:

  • http.method, http.url, http.querystringstatus.code
  • action.type (CRUD, GraphQL művelet)
  • user.role, user-agent
  • data-source.type, data-source.name
  • api.type (REST vagy GraphQL)

A hibák és kivételek részletes információval is nyomon követhetők.

Data API builder Metrics

A DAB OpenTelemetry-metrikákat bocsát ki, például:

  • Total Requests: Counter, labeled by HTTP method, status, endpoint, and API type.
  • Errors: Counter, labeled by error type, HTTP method, status, endpoint, and API type.
  • Request Duration: Histogram (in milliseconds), labeled as above.
  • Active Requests: Up/down counter for concurrent requests.

A metrikák a .NET Meter API-t és az OpenTelemetry SDK-t használják.

Configuration

Adjon hozzá egy szakasztopen-telemetry a konfigurációs fájlbanruntime.telemetry.

{
    "runtime": {
        "telemetry": {
            "open-telemetry": {
                "enabled": true,
                "endpoint": "http://otel-collector:4317",
                "service-name": "dab",
                "exporter-protocol": "grpc"
            }
        }
    }
}

CLI Options

Configure OpenTelemetry via CLI flags:

  • dab configure --otel-enabled true
  • dab configure --otel-endpoint "http://otel-collector:4317"
  • dab configure --otel-protocol "grpc"
  • dab configure --otel-service-name "dab"
  • dab configure --otel-headers

Exportálás és vizualizáció

A telemetriát a .NET OpenTelemetry SDK-val exportálja a konfigurált háttérrendszerbe, például az Azure Monitorba vagy a Jaegerbe. Győződjön meg arról, hogy a háttérrendszer fut és elérhető a megadott endpointhelyen.

Implementation Notes

  • A nyomkövetések és a metrikák az összes REST-, GraphQL- és DB-műveletet lefedik
  • A köztes szoftver és a hibakezelők telemetriát is bocsátanak ki
  • A környezet propagálása kérésekkel történik
  • Last updated on