Como registrar recursos locais com o BindPlane

Esse documento compõe uma série em duas partes sobre como estender o Cloud Logging e o Cloud Monitoring para incluir infraestrutura e apps no local.

  • Logging (este documento): leia sobre a compatibilidade do Logging com a geração de registros de recursos locais.
  • Monitoring: leia sobre como o Monitoring oferece suporte ao monitoramento de recursos locais.

Use o Loggin e o Monitoring para monitorar e gerar registros dos recursos locais pelos motivos a seguir:

  • Você quer uma solução temporária enquanto migra a infraestrutura para o Google Cloud e quer registrar e monitorar seus recursos locais até que eles sejam desativados.
  • Talvez você tenha um ambiente de computação diversificado com várias nuvens e recursos locais.

Em ambos os casos, com a API do Loggin e do Monitoring e o BindPlane, é possível ter visibilidade de seus recursos locais. Esse documento destina-se a profissionais, gerentes e executivos de DevOps interessados em uma estratégia de monitoramento para recursos no Google Cloud e nos aplicativos e infraestrutura locais restantes.

Como ingerir registros com o Logging

É possível gerar registros no Logging usando a API de duas maneiras compatíveis:

  • Use o BindPlane do observIQ para ingerir registros de suas fontes locais ou de outras fontes na nuvem.
  • Use a API Google Cloud diretamente do app ou usando um agente personalizado.

Como usar o BindPlane para ingerir registros do Logging

O diagrama a seguir mostra a arquitetura de como o BindPlane ingere registros e, em seguida, como esses registros são ingeridos no Logging.

Arquitetura de uso do Logging e do BindPlane para ingerir registros locais.

O BindPlane permite que os usuários implantem e gerenciem remotamente coletores nos hosts dos quais desejam coletar registros. Para mais informações, leia sobre a arquitetura do BindPlane. Essa opção requer o menor esforço para implantar, porque requer configuração para configurar, em vez de desenvolvimento.

Vantagens:

  • Requer configuração, não desenvolvimento.
  • Incluído no custo de uso do Logging.
  • É uma configuração compatível com produtos e suporte do Logging.
  • Pode se estender para registros não fornecidos pela configuração padrão.

Desvantagens:

  • Requer o uso de uma ferramenta de terceiros.
  • Pode ser necessário fornecer uma configuração personalizada se a origem do registro não for fornecida por padrão. A lista de registros fornecida está disponível em Fontes.

Como usar a API Logging

O diagrama a seguir mostra a arquitetura de como os registros são coletados por instrumentação e ingeridos no Logging.

Arquitetura de uso da API Logging para ingerir diretamente registros locais.

Usar as APIs diretamente significa que você precisa instrumentar seus aplicativos de modo a enviar registros diretamente à API ou desenvolver um agente personalizado para enviar registros a ela. Essa é a opção que requer o nível mais alto de esforço, porque exige um trabalho de desenvolvimento.

Vantagens:

  • Fornece flexibilidade porque a instrumentação pode ser implementada com as bibliotecas de geração de registros do cliente.

Desvantagens:

  • Requer uma solução separada para registros de infraestrutura, como um agente personalizado.
  • Requer instrumentação de código, o que pode significar maior custo para implementar.
  • Requer o uso de lotes e outras técnicas de ingestão escalonáveis para desempenho de ingestão adequado.
  • O suporte é fornecido apenas para a API de registro, não para o código personalizado.

Como usar o BindPlane

Este documento aborda o uso da ferramenta BindPlane do observIQ para ingerir registros no Logging. Como está incluído no custo do Logging, o BindPlane não exige desenvolvimento e fornece uma solução compatível com produto.

Agentes, origens e destinos

Para informações detalhadas sobre agentes, origens e destinos, consulte o Guia de início rápido do BindPlane.

Exemplo de caso de uso:

Os clientes corporativos usam o BindPlane para ingerir registros nos seguintes cenários de geração de registros no local:

  1. Análise e filtragem personalizadas dos dados de registros de aplicativos personalizados.
  2. Coleção de eventos do sistema operacional a partir de máquinas virtuais Linux ou Windows.
  3. Ingestão de streams syslog da rede ou de outros dispositivos compatíveis.
  4. Coleção de registros de sistema e aplicativo do Kubernetes.

Enviar registros do local para o Logging

Depois de configurar o BindPlane e começar a enviar registros, eles serão enviados para o Logging. Para ver, processar e exportar registros, acesse o Console do Google Cloud. Os registros são listados como os tipos de recurso generic_node ou generic_task. Para mais informações sobre os rótulos incluídos em cada tipo de recurso, consulte a lista de recursos do Logging.

O Cloud Logging é compatível com registros que não são próprios ao usar dois tipos de recurso:

  • Nó genérico: identifica uma máquina ou outro recurso computacional ao qual nenhum outro tipo de recurso é aplicável. Os valores do rótulo precisam identificar exclusivamente o nó.
  • Tarefa genérica: identifica um processo de app para o qual nenhum outro recurso é aplicável, como um processo programado por um sistema de orquestração personalizado. Os valores do rótulo precisam identificar exclusivamente a tarefa.

Ver registros no Logging

No Console do Google Cloud, o nó genérico é exibido como um tipo de recurso na lista da página do Logging.

Lista de recursos no Logging

Os registros a seguir foram capturados como o tipo de recurso generic_node e aparecem no Logging.

Lista de registros no Logging.

A entrada de registro a seguir usa um formato de geração de registros estruturados, que é mais avançado para a pesquisa de registros, já que o payload do registro é armazenado como jsonPayload. O formato de geração de registros estruturados torna os registros mais acessíveis, porque é possível usar os campos no payload como parte da pesquisa. O agente de geração de registros do BindPlane fornece um mapeamento da entrada de registro original para o registro estruturado no Logging.

Entrada de registro no formato de geração de registros estruturados.

Conclusão

Com os registros disponíveis no Logging, você aproveita ao máximo os recursos dele. Os registros aparecem no Console do Google Cloud. Exporte registros com exportações do Logging e use-os para criar métricas e alertas no Monitoring usando métricas com base em registros.

A seguir