Operace GraphQL
Protokoly operací GraphQL jsou součástí protokolů monitorování pracovního prostoru a jsou zaregistrované v databázi Eventhouse KQL, která je součástí řešení analýzy v reálném čase. Tyto protokoly můžete použít ke sledování využití a výkonu pracovního prostoru.
Protokoly operací GraphQL
Událost protokolu pro každý dotaz spuštěný rozhraním API Fabric pro GraphQL v připojených zdrojích dat se ukládá do dvou tabulek: GraphQLMetrics a GraphQLLog.
Protokoly dotazů použijte k:
- Identifikace změn chování a potenciálního snížení výkonu rozhraní API
- Detekce neobvyklých dotazů nebo dotazů náročných na prostředky
- Identifikace uživatelů a aplikací s nejvyšším počtem dotazů
- Analýza výkonu a trendů dotazů
- Řešení potíží s pomalými dotazy
- Diagnostika problémů s konkrétními dotazy GraphQL
Tato tabulka uvádí protokoly GraphQL.
| Název sloupce | Typ | Popis |
|---|---|---|
| Časové razítko | datetime | Časové razítko (UTC) doby, kdy byla položka protokolu vygenerována při vytvoření záznamu zdrojem dat. |
| ItemId | řetězec | Jedinečné ID prostředku, který data protokoluje. |
| ItemKind | řetězec | Typ artefaktu protokolování operace. |
| ItemName | řetězec | Název artefaktu infrastruktury, který tuto operaci protokoluje. |
| WorkspaceId | řetězec | Jedinečný identifikátor pracovního prostoru Fabric, který obsahuje artefakt, na který se pracuje |
| Název pracovního prostoru | řetězec | Název pracovního prostoru Fabric obsahujícího artefakt |
| CapacityId | řetězec | Jedinečný identifikátor kapacity hostující artefakt, na který se pracuje. |
| CustomerTenantId | řetězec | ID tenanta zákazníka, kde byla operace provedena. |
| PlatformMonitoringTableName | řetězec | Název tabulky k záznamům patří (nebo certifikovaný typ události záznamu). Formát je <WorkloadName> + [OperationType>]+ <TelemetryType> |
| Oblast | řetězec | Oblast prostředku vygenerující událost; Například USA – východ nebo Francie – jih. |
| MetricTimeGrain | řetězec | Časové intervaly metriky (ISO 8601 Duration) |
| MetricUnitName | řetězec | Jednotka metriky |
| MetricSumValue | long | Agregovaná hodnota součtu metriky během jedné minuty. |
| Typy zdrojů dat | dynamic | Pole typů DataSource, které model používá. |
| ResultCode | řetězec | Kód chyby neúspěšných aktivit, který se používá k rozšíření využití na spolehlivost. |
| Průběh | řetězec | Stav operace. Dotaz se úspěšně spustil/ úspěšně s chybami nebo selháním. |
Atributy protokolu GraphQL
Tato tabulka popisuje atributy GraphQLLogs. Další informace o událostech a přechodu k podrobnostem události ExecutionMetrics naleznete v tématu Události a schéma.
| Název sloupce | Typ | Popis |
|---|---|---|
| Časové razítko | datetime | Časové razítko (UTC) doby, kdy byla položka protokolu vygenerována při vytvoření záznamu zdrojem dat. |
| OperationName | řetězec | Název operace |
| ItemId | řetězec | Jedinečné ID prostředku, který data protokoluje. |
| ItemKind | řetězec | Typ artefaktu protokolování operace. |
| ItemName | řetězec | Název artefaktu infrastruktury, který tuto operaci protokoluje. |
| WorkspaceId | řetězec | Jedinečný identifikátor pracovního prostoru Fabric, který obsahuje artefakt, na který se pracuje. |
| Název pracovního prostoru | řetězec | Název pracovního prostoru Fabric obsahujícího artefakt |
| CapacityId | řetězec | Jedinečný identifikátor kapacity hostující artefakt, na který se pracuje. |
| CorrelationId | řetězec | ID kořenové aktivity. |
| Id operace | řetězec | Jedinečný identifikátor operace, která se protokoluje. |
| Identita | dynamic | Podrobnosti o uživateli a deklaraci identity Uživatel přidružený k operaci, která se hlásí. |
| CustomerTenantId | řetězec | ID tenanta zákazníka, kde byla operace provedena. |
| DurationMs | long | Uplynulá doba procesoru, která uplynula, zatímco byly zpracovány všechny požadované operace. Jednotka je v milisekundách. |
| Průběh | řetězec | Stav operace. Dotaz se úspěšně spustil/ úspěšně s chybami nebo selháním. |
| Level | řetězec | Metadata vyžadovaná týmem pro monitorování platformy |
| Oblast | řetězec | Oblast prostředku vygenerující událost; Například USA – východ nebo Francie – jih. |
| PlatformMonitoringTableName | řetězec | Název tabulky k záznamům patří (nebo certifikovaný typ události záznamu). Formát je <WorkloadName> + [OperationType>]+ <TelemetryType> |
| Text dotazu | řetězec | Text dotazu. |
| GraphQLOverheadDurationMs | long | Režie GraphQL v ms pro požadavek na rovinu dat. |
| Zpracovanébyty | long | Zpracovávaný objem dat v bajtech |
| TransportProtocol | řetězec | Přenosový protokol pro požadavek. |
| QueryResultMessage | řetězec | Tato dimenze slouží k poskytnutí dalšího kontextu výsledku operace dotazu. |
Vzorové dotazy
Ukázkové dotazy najdete v úložišti GitHub s ukázkami prostředků infrastruktury.