A trilha de API de nuvem

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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
    O formulário Trilha de API de 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 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.

    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:

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

    Abrir a Trilha de API de nuvem

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