A trilha da API em nuvem

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura
  • A Trilha de API em Nuvem é um log de atividades para todas as atividades que usam a API em Nuvem e passa por MID Server.

    Conteúdo da trilha de API em nuvem

    Figura 1. Formulário de trilha de CAPI
    O formulário de Trilha de API em nuvem
    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
    Parâmetros de entrada O parâmetro de entrada que gerou o registro da trilha da 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 em nuvem que processou este registro.
    Nome do provedor O provedor de nuvem.
    Versão A versão especificada na API do Cloud.

    Logs de Trilha de CAPI

    A lista relacionada Logs de Trilha de CAPI fornece mais detalhes sobre a entrada de trilha de API em Nuvem. Os seguintes tipos de chaves de log estão disponíveis:

    Chave de log Descrição
    dados_da_rota Informações sobre as chamadas de API em nuvem.
    rota_dinâmico Informações sobre a rota real usada pelos dados, incluindo URIs.
    rota_result 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.
    rota_status Se a conexão de rota e a transferência de carga foram bem-sucedidas.
    erro_rota O erro que ocorreu. Por exemplo, o erro Falha ao listar Falha no balanceador de carga: Código de erro HTTP: 403 significa que suas credenciais estavam incorretas e Descoberta não pôde acessar o recurso de nuvem.
    error_detail Mais detalhes sobre o erro, incluindo a API Cloud Provisioning and Governance e o conector que foi usado na tentativa Descobertae os erros que o provedor de nuvem gerou.
    Um exemplo de um route_error é 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 que Descoberta não pôde acessar o recurso de nuvem. A interface do balanceador de carga gera o primeiro erro porque o dispositivo do balanceador de carga é o primeiro dispositivo que permite o acesso ao recurso de nuvem. Os erros org.apache.camel 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.

    Abrir a Trilha de API em Nuvem

    Abra a Trilha de API em 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é Operar > Trilhas.
    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 um com falha 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 em 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.