Szűrt naplószintek használata

A Data API Builder (DAB) támogatja a testre szabható, szűrt naplószinteket, így szabályozhatja a naplók részletességét és fókuszát. Ez lehetővé teszi, hogy részletes diagnosztikát kapjon bizonyos összetevőkről, miközben más területeket is csendesebbé tesz, így javítva a hibakeresési és monitorozási élményt.

A naplózási beállítások a runtime.telemetry.log-level konfiguráció szakaszában vannak konfigurálva. A részletes vezérléshez megadhatja a naplószinteket globálisan, vagy célspecifikus névtereket vagy osztályokat.

Naplószintű prioritások

• A legspecifikusabb névtér vagy osztálynév elsőbbséget élvez.

• A default kulcs az összes olyan összetevő alapszintjét állítja be, amely nem szerepel explicit módon a listán.

• Ha nincs megadva, a DAB a gazdagép üzemmódja alapján az alapértelmezett szinteket használja:

  • development mode defaults to Debug (részletes)
  • production mode defaults to Error (kevésbé részletes)

Támogatott naplószintek

• Trace: Rögzítse a legrészletesebb és legrészletesebb információkat, amelyek általában csak a folyamat minden lépésének részletes hibaelhárításához vagy megértéséhez hasznosak.
• Debug: Adjon meg részletes információkat a problémák diagnosztizálására és a folyamat megértésére a fejlesztés során.
• Information: Rögzítse a normál műveleteket és mérföldköveket leíró általános, magas szintű eseményeket.
• Warning: Olyan váratlan helyzeteket vagy kisebb problémákat jelezhet, amelyek nem hagyják abba a feldolgozást, de figyelmet igényelhetnek.
• Error: Naplóhibák, amelyek megakadályozzák, hogy egy művelet sikeresen befejeződik, de ne összeomlasson a rendszer.
• Critical: Súlyos problémák jelentése, amelyek rendszer- vagy fő funkcióhibát okoznak, és azonnali beavatkozást igényelnek.
• None: Tiltsa le a naplózást a célzott kategória vagy összetevő összes üzenetének letiltásához.

A névtérnevek részleges egyezései támogatottak, de elválasztójelen . kell végződniük. For example:

• Azure.DataApiBuilder.Core.Configurations.RuntimeConfigValidator
• Azure.DataApiBuilder.Core
• default

Example configuration

{
  "runtime": {
    "telemetry": {
      "log-level": {
        "Azure.DataApiBuilder.Core.Configurations.RuntimeConfigValidator": "Debug",
        "Azure.DataApiBuilder.Core": "Information",
        "default": "Warning"
      }
    }
  }
}

Ebben a példában:

• Az osztály naplói RuntimeConfigValidator a Debug szinten jelennek meg.
• Egyéb, használat Information alatt álló Azure.DataApiBuilder.Core osztályok.
• Az összes többi napló alapértelmezés szerint szintre van kapcsolva Warning .

Hot-reload support

A naplószintek dinamikusan (újratöltéssel) frissíthetők fejlesztési és éles módban is az alkalmazás újraindítása nélkül. Ez segít a naplózás menet közbeni beállításában a problémák elhárításához.

Fontos névterek a szűréshez

Néhány gyakori névtér/osztály, amelyet szűrni szeretne:

• Azure.DataApiBuilder.Core.Configurations.RuntimeConfigValidator
• Azure.DataApiBuilder.Core.Resolvers.SqlQueryEngine
• Azure.DataApiBuilder.Core.Resolvers.IQueryExecutor
• Azure.DataApiBuilder.Service.HealthCheck.ComprehensiveHealthReportResponseWriter
• Azure.DataApiBuilder.Service.Controllers.RestController
• Azure.DataApiBuilder.Auth.IAuthorizationResolver
• Microsoft.AspNetCore.Authorization.IAuthorizationHandler
• default