Trasování

  • Článek

PLATÍ PRO: Všechny úrovně služby API Management

Tato trace zásada přidá vlastní trasování do výstupu trasování požadavků v testovací konzole, v aplikační Přehledy telemetrie a/nebo do protokolů prostředků.

  • Zásada při aktivaci trasování přidá do výstupu trasování požadavků v testovací konzole vlastní trasování.
  • Zásada vytvoří telemetrii trasování v Přehledy aplikace, pokud je povolená integrace Přehledy aplikace a severity zadaná v zásadách je rovna nebo větší než verbosity zadaná v nastavení diagnostiky.
  • Zásada přidá do položky protokolu vlastnost, pokud jsou povoleny protokoly prostředků a úroveň závažnosti zadaná v zásadách je vyšší nebo vyšší než úroveň podrobností zadaná v nastavení diagnostiky.
  • Zásady nejsou ovlivněny vzorkováním Přehledy aplikací. Zaprotokolují se všechna vyvolání zásad.

Důležité

  • Trasování požadavků služby API Management už nejde povolit nastavením hlavičky Ocp-Apim-Trace v požadavku a použitím hodnoty hlavičky Ocp-Apim-Trace-Location v odpovědi na načtení trasování.
  • Pokud chcete zlepšit zabezpečení, trasování je teď povolené na úrovni jednotlivých rozhraní API získáním časově omezeného tokenu pomocí rozhraní REST API služby API Management a předáním tokenu v požadavku na bránu. Podrobnosti najdete dále v tomto kurzu.
  • Při povolování trasování je potřeba dbát na to, jak může v datech trasování vystavit citlivé informace. Ujistěte se, že máte k ochraně dat trasování zavedená vhodná bezpečnostní opatření.

Poznámka:

Trasování požadavků rozhraní API se v současné době nepodporuje na úrovních Basic v2 a Standard v2.

Poznámka:

Nastavte prvky zásad a podřízené prvky v pořadí uvedeném v prohlášení o zásadách. Přečtěte si další informace o tom, jak nastavit nebo upravit zásady služby API Management.

Prohlášení o zásadách

<trace source="arbitrary string literal" severity="verbose | information | error">
    <message>String literal or expressions</message>
    <metadata name="string literal or expressions" value="string literal or expressions"/>
</trace>

Atributy

Atribut Popis Požaduje se Výchozí
zdroj Řetězcový literál smysluplný pro prohlížeč trasování a určení zdroje zprávy. Výrazy zásad nejsou povolené. Yes –
závažnost Určuje úroveň závažnosti trasování. Povolené hodnoty jsou verbose, informationerror (od nejnižšího po nejvyšší). Výrazy zásad nejsou povolené. No verbose

Elementy

Název Popis Povinní účastníci
zpráva Řetězec nebo výraz, který se má protokolovat. Výrazy zásad jsou povolené. Ano
metadata Přidá vlastní vlastnost do telemetrie trasování Přehledy aplikace. No

atributy metadat

Atribut Popis Požaduje se Výchozí
name Název vlastnosti. Yes –
hodnota Hodnota vlastnosti Yes –

Využití

Příklad

<trace source="PetStore API" severity="verbose">
    <message>@((string)context.Variables["clientConnectionID"])</message>
    <metadata name="Operation Name" value="New-Order"/>
</trace>

Související obsah

Další informace o práci se zásadami najdete v tématech: