Rastreio

  • Artigo

APLICA-SE A: Todas as camadas de gerenciamento de API

A trace política adiciona um rastreamento personalizado à saída de rastreamento de solicitação no console de teste, telemetrias do Application Insights e/ou logs de recursos.

  • A política adiciona um rastreamento personalizado à saída de rastreamento de solicitação no console de teste quando o rastreamento é acionado.
  • A política cria uma telemetria de rastreamento no Application Insights, quando a integração do Application Insights está habilitada e o severity especificado na política é igual ou maior do que o verbosity especificado na configuração de diagnóstico.
  • A política adiciona uma propriedade na entrada de log quando os logs de recursos são habilitados e o nível de gravidade especificado na política é igual ou superior ao nível de detalhamento especificado na configuração de diagnóstico.
  • A política não é afetada pela amostragem do Application Insights. Todas as invocações da política serão registradas.

Importante

  • O rastreamento de solicitações do Gerenciamento de API usando o cabeçalho Ocp-Apim-Trace em uma solicitação e usando o valor do cabeçalho de resposta Ocp-Apim-Trace-Location está sendo preterido.
  • Para melhorar a segurança, o rastreamento agora pode ser habilitado no nível de uma API individual, obtendo um token por tempo limitado usando a API REST de Gerenciamento de API e passando o token em uma solicitação para o gateway. Para obter detalhes, consulte Habilitar o rastreamento de uma API.
  • Tenha cuidado ao ativar o rastreamento, pois ele pode expor informações confidenciais nos dados de rastreamento. Certifique-se de que tem em vigor as medidas de segurança adequadas para proteger os dados de rastreio.

Nota

Defina os elementos da política e os elementos filho na ordem fornecida na declaração de política. Saiba mais sobre como definir ou editar políticas de Gerenciamento de API.

Declaração de política

<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>

Atributos

Atributo Description Necessário Predefinição
origem String literal significativa para o visualizador de rastreamento e especificando a origem da mensagem. Expressões de política não são permitidas. Sim N/A
gravidade Especifica o nível de severidade do rastreamento. Os valores permitidos são verbose, information, error (do mais baixo para o mais alto). Expressões de política não são permitidas. Não verbose

Elementos

Nome Descrição Obrigatório
mensagem Uma cadeia de caracteres ou expressão a ser registrada. São permitidas expressões de política. Sim
do IdP Adiciona uma propriedade personalizada à telemetria de rastreamento do Application Insights. Não

atributos de metadados

Atributo Description Necessário Predefinição
nome Nome do imóvel. Sim N/A
valor Valor do imóvel. Sim N/A

Utilização

Exemplo

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

Conteúdos relacionados

Para obter mais informações sobre como trabalhar com políticas, consulte: