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 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. Este documento é destinado a profissionais, gerentes e executivos de DevOps interessados em uma estratégia de geração de registros 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.
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.
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:
- Análise e filtragem personalizadas dos dados de registros de aplicativos personalizados.
- Coleção de eventos do sistema operacional a partir de máquinas virtuais Linux ou Windows.
- Ingestão de streams syslog da rede ou de outros dispositivos compatíveis.
- 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 doGoogle 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 doGoogle 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
- Geração de registros e monitoramento
- Instruções de configuração do BindPlane para o Cloud Monitoring e o Logging
- Configurar métricas com base em registros no Logging
- Para mais arquiteturas de referência, diagramas e práticas recomendadas, confira a Central de arquitetura do Cloud.