Encaminhamento de log do caminho de dados

Os logs de dados e de verificação de funcionamento são valiosos para propósitos de depuração e manutenção. Com o recurso de registro de caminho de dados ativado, o IBM Cloud® Virtual Private Cloud Application Load Balancer for VPC (ALB) encaminha esses registros para o IBM Cloud Logs painel de controle da sua conta.

Para ativar ou desativar o recurso de criação de log de caminho de dados, é possível:

  • Criar um balanceador de carga e ativar ou desativar o botão de alternância.

  • Use a CLI para configurar a propriedade --logging-datapath-active como true para balanceadores de carga existentes.

  • Use a API para ativar a criação de log de caminho de dados.

Se você não tiver uma instância do Log Analysis, crie uma antes de ativar o registro do caminho de dados.

Exemplos de saída de log

A saída a seguir é um exemplo de criação de log de caminho de dados do IBM Cloud Application Load Balancer for VPC:

Sep 28 11:25:04 is-load-balancer crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf
{"PRIORITY":"info", "MSG_timestamp":"2020-09-28T03:25:03.136101+00:00", "SentByHost":"150.238.66.162", "MESSAGE":" Connect from 222.72.143.92:38605 to 10.240.128.5:62776 (r006-6ba32c0e-830c-483c-871a-0240c10662cf/HTTP)", "logSourceCRN":"crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf", "saveServiceCopy":false}

Os logs contêm o cabeçalho de log e a sequência JSON.

O cabeçalho de log é construído com a data e hora (Sep 28 11:25:04), origem de log (is-load-balancer) e CRN de origem de log (crn:v1:bluemix:public:is:us-south...).

O log do caminho de dados é uma sequência JSON, contendo os campos a seguir:

Campos de registro do caminho de dados
Nome do campo Tipo Descrição
PRIORITY string O nível de log associado a cada mensagem sobre a gravidade do log.
MSG_timestamp string O registro de data e hora que indica quando o log foi gerado.
SentByHost string O endereço IP do host.
MENSAGEM string A descrição sobre o arquivo de log.
logSourceCRN string O local de salvamento do arquivo de log na instância do Log Analysis da conta indicada no CRN.
saveServiceCopy bool Indica se deve salvar um log no Log Analysis STS, o valor padrão é false.

A seguir há um exemplo do esquema JSON de um log de caminho de dados:

{
    "type": "object",
    "properties": {
        "PRIORITY": {
            "type": "string"
        },
        "MSG_timestamp": {
            "type": "string"
        },
        "SentByHost": {
            "type": "string"
        },
        "MESSAGE": {
            "type": "string"
        },
        "logSourceCRN": {
            "type": "string"
        },
        "saveServiceCopy": {
            "type": "boolean"
        }
    }
}

Observe que:

  • PRIORITY é o nível de log que está associado a cada mensagem sobre a gravidade do log. Atualmente, a única opção é info.
  • MSG_timestamp é o registro de data e hora na Hora Universal Coordenada.
  • SentByHost é o VIP do dispositivo. Para balanceadores de carga públicos, este é o IP flutuante, para balanceadores de carga privados, este é um IP privado.
  • MESSAGE é o conteúdo da mensagem de log.
  • logSourceCRN indica qual instância do Log Analysis usar para salvar os logs para a conta.
  • saveServiceCopy é false (por padrão) e não pode ser mudado.

O formato dos logs pode ser impactado por upgrades internos. Recomenda-se usar essas mensagens apenas para propósitos de depuração, não para automação de construção.