---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# A trilha de API de nuvem

# A trilha de API de nuvem {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A Trilha de API da nuvem é um log de atividades para todas as atividades que usam a API da nuvem e passam pelo MID Server.

## Conteúdos da Trilha de API da nuvem

Figura 1. Formulário de trilha de CAPI {#cloud-api-trail__table_ibs_2x5_gz__entry__2}

| Campo | Descrição |
|-|-|
| ID de rota dinâmica | Um número de ID gerado automaticamente para a entrada. |
| Nome de MID | O nome do MID Server por meio do qual o Descoberta foi realizado. |
| Status da rota | Se a operação Descoberta executada pela API foi bem-sucedida ou não. Os valores possíveis são: * êxito * error * executando {#cloud-api-trail__ul_nft_2y5_gz} |
| Parâmetros de entrada | O parâmetro de entrada que gerou o registro da trilha de API. Esse valor geralmente é o datacenter no qual o Descoberta foi executado. |
| Nome da interface |   |
| Invocado por | Este valor é sempre CMP ao executar Descoberta. |
| Nome do método | A operação de interface da API da nuvem que processou este registro. |
| Nome do provedor | O provedor de nuvem. |
| Versão | A versão especificada na API da nuvem. |
[ ]

{#cloud-api-trail__table_ibs_2x5_gz}

## Logs de Trilha de CAPI

A lista relacionada Logs de trilha de CAPI fornece mais detalhes sobre a entrada de trilha de API de nuvem. Os seguintes tipos de chaves de log estão disponíveis:  
{#cloud-api-trail__table_wxx_bgv_gz__entry__2}

| Chave de log | Descrição |
|-|-|
| dados_rota | Informações sobre as chamadas de API da nuvem. |
| roteamento_dinâmico | Informações sobre a rota real que os dados seguiram, incluindo URIs. |
| resultado_rota | A carga recebida pela instância ou uma descrição do resultado da transferência de dados. A carga |
| bloco_número | O número de blocos de dados que a instância recebeu. |
| status_rota | Se a conexão de rota e a transferência de carga foram bem-sucedidas. |
| erro_rota | O erro ocorrido. Por exemplo, o erro `Failed to list loadbalancer Failed : HTTP error code : 403` significa que suas credenciais estavam incorretas e Descoberta não pôde acessar o recurso de nuvem. |
| erro_detalhe | Mais detalhes sobre o erro, incluindo a Cloud Provisioning and Governance API e o conector que foram usados na tentativa de Descobertae os erros que o provedor de nuvem gerou. |
[ ]

{#cloud-api-trail__table_wxx_bgv_gz}  
Um exemplo de um erro de rota é o seguinte:

    Failed to list loadbalancer Failed : HTTP error code : 403

Um exemplo da entrada error_detail para o mesmo erro é o seguinte:  

    com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerException: Failed to list loadbalancer Failed : HTTP error code : 403
           at com.snc.cmp.connector.cloud.loadbalancer.customizer.impl.AWSLoadBalancerCustomizer.listLoadBalancers(AWSLoadBalancerCustomizer.java:56)
    	at com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerProducer.process(LoadBalancerProducer.java:46)
    	at org.apache.camel.util.AsyncProcessorConverterHelper$ProcessorToAsyncProcessorBridge.process(AsyncProcessorConverterHelper.java:61)
           at org.apache.camel.processor.SendProcessor.process(SendProcessor.java:145)
           ...

Essas duas entradas indicam que as credenciais estavam incorretas e Descoberta não pôde acessar o recurso de nuvem. A interface do balanceador de carga gera o primeiro erro porque o dispositivo balanceador de carga é o primeiro dispositivo que permite o acesso ao recurso de nuvem. Os erros `org.apache.camelo` indicaram erros de roteamento no lado da Amazon Web Services.

O erro correspondente no lado da instância é capturado na Trilha de Orquestração em nuvem.
**Conceitos relacionados**   

* [A trilha de Orquestração em nuvem](https://servicenow-prod.fluidtopics.net/mA6GvdDtnJ9pX2SFAAGjrw "A Trilha de Orquestração em nuvem é um log de atividades para todas as atividades de recursos de nuvem na instância.")

## Abrir a Trilha de API de nuvem {#ariaid-title2}

Abra a Trilha de API de nuvem para depurar e solucionar problemas como uma política com falha ou falha Descoberta de recursos de nuvem.

### Antes de Iniciar

Função necessária: sn_cmp.cloud_operator ou sn_cmp.cloud_admin

### Procedimento

1. No Portal de administração de nuvem, navegue até OperarTrilhas.
2. Na guia Trilha de API em nuvem, filtre e classifique a lista de registros de Trilha de API em nuvem conforme necessário.  
   Se você estiver procurando por algo como falhou Descoberta, filtre a lista para que a coluna Status da rota mostre somente entradas com erro.
3. Clique em um link na coluna Criado para abrir o registro da Trilha de API de nuvem.
4. Na lista relacionada Logs de trilha de CAPI, abra o registro de log que exibe as informações desejadas.  
   Por exemplo, abra route_error ou error_detail para depurar uma operação com falha.