Registrar recursos no local com o BindPlane

Last reviewed 2024-08-02 UTC

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.

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

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 no local. 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 no local 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 agentes 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 do 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

Na página do Análise de registros, a lista Todos os recursos inclui o nó genérico como um tipo de recurso.

A lista de registros que aparece na página foi capturada como o tipo de recurso generic_node. Abra uma linha para conferir os detalhes da entrada de registro.

As entradas de registro usam 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 do BindPlane fornece um mapeamento da entrada de registro original para a entrada de registro estruturada no Logging.

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