O Container-Optimized OS inclui o agente legado do Logging do pacote de operações do Google Cloud, que exporta alguns registros de sistema e contêiner para o Cloud Logging. Este documento se concentra em como usar o agente do Logging no Container-Optimized OS e como acessar registros.
Como ativar o agente do Logging
O agente do Logging está desativado por padrão. É possível ativar esse recurso ao criar uma nova instância ou atualizar uma instância existente.
Como criar uma nova instância com o agente do Logging ativado
Console
Para executar uma instância do Compute Engine no Container-Optimized OS com o agente do Logging ativado, faça o seguinte:
Abra a página de criação de instâncias do Compute Engine no Console do Google Cloud.
Especifique um Nome para sua instância.
Na seção Disco de inicialização, selecione uma imagem do Container-Optimized OS.
Clique em Gerenciamento, segurança, discos, rede, locatário único para expandir outras opções.
Na guia Gerenciamento, role até a seção Metadados. Adicione uma nova entrada de metadados, com Chave como
google-logging-enablede Valor comotrue.Se quiser, especifique qualquer outra opção para seu caso de uso. Consulte Como criar e configurar instâncias para mais detalhes.
Clique em Criar para criar e inicializar a instância.
gcloud
Para executar uma instância do Compute Engine no Container-Optimized OS com o agente do
Logging ativado, use o comando gcloud compute instances create e inclua
google-logging-enabled=true nos metadados. Exemplo:
gcloud compute instances create instance-name \
--image-family cos-stable \
--image-project cos-cloud \
--zone compute-zone \
--metadata google-logging-enabled=true
Substitua:
- instance-name: o nome da instância de VM.
- compute-zone: a zona de computação da instância.
Para mais informações sobre o comando gcloud, consulte a
documentação de referência de
gcloud compute instances create.
Para mais detalhes sobre como criar instâncias do Container-Optimized OS, consulte
Como criar e configurar instâncias.
Como atualizar uma instância existente para ativar ou desativar o agente do Logging
Console
Acesse a página "Instâncias de VMs".
Clique no nome da instância do Container-Optimized OS que você quer atualizar.
Clique em "Editar" na barra superior Detalhes da instância de VM.
Na seção Metadados personalizados, adicione uma nova entrada de metadados, com Chave como
google-logging-enablede Valor comotruepara ativar oufalsepara desativar.Clique em Save.
gcloud
Para ativar ou desativar o agente do Logging em uma instância existente, use o comando gcloud
compute instances add-metadata:
gcloud compute instances add-metadata instance-name \
--zone compute-zone \
--metadata google-logging-enabled=enabled-value
Substitua:
- enabled-value:
truepara ativar,falsepara desativar. - instance-name: o nome da instância de VM.
- compute-zone: a zona de computação da instância.
Como ativar o agente do Logging nos metadados do projeto
A partir do marco 97, a geração de registros pode ser ativada nos metadados do projeto:
gcloud compute project-info add-metadata \
--metadata google-logging-enabled=true
Como acessar os registros
Console
Acesse a página "Instâncias de VMs".
Clique no nome da instância do Container-Optimized OS da qual você quer acessar os registros.
Na seção Registros, clique em Cloud Logging.
Isso abre o Explorador de registros da instância especificada. Para mais informações, consulte Como usar o Explorador de registros.
gcloud
Para acessar os registros, use o comando gcloud logging read. Exemplo:
gcloud logging read \
"resource.type=gce_instance AND resource.labels.instance_id=instance-id" \
--limit 10 \
--format json \
--freshness 30d
Substitua:
- instance-id: o ID da instância da VM.
Esse comando tenta ler registros da instância de VM com instance-id, limitando a 10 registros, no formato JSON, dos últimos 30 dias.
Para mais informações sobre o comando gcloud, consulte a
documentação de referência de
gcloud logging read.
Como funciona?
O agente do Logging é configurado por padrão para enviar registros de determinados serviços críticos do sistema e contêineres de aplicativos do usuário para o back-end do Cloud Logging. Por exemplo, registros de contêineres do Docker, serviços de sistema selecionados, registros de auditoria, erros de registro de diário etc. Consulte a origem de configuração específica do Container-Optimized OS para uma configuração de registro padrão completa. O comando do Docker que inicia o agente do Logging é definido na origem do serviço system-logging do Container-Optimized OS. A versão do agente conteinerizado em execução é definida no diretório app-admin/Stackdriver de origem do Container-Optimized OS.
Limitações conhecidas
Compatibilidade com o driver gcplogs
A partir do
março 89,
se o agente do Logging incluído no Container-Optimized OS estiver ativado e o driver de
geração de registros do gcplogs no Docker estiver ativado para um ou mais contêineres, os registros de
aviso excessivos podem ser emitidos pelo agente do Logging incluído. Isso pode criar ruídos de
registro e/ou aumentar as cobranças relacionadas ao Cloud Logging.
Uma solução alternativa é não usar gcplogs como um driver de geração de registros do Docker e,
em vez disso, usar o driver padrão, conforme configurado pelo Container-Optimized OS. O
agente do Logging incluído no Container-Optimized OS exportará
os registros de contêiner para o Cloud Logging. Portanto, não é necessário usar as duas soluções
simultaneamente.
Referências
- Agente de geração de registros legado do agente de operações do Google Cloud documentação. O agente do Logging conteinerizado incluído no Container-Optimized OS é um subconjunto do agente legado do Logging. Portanto, esta documentação pode fornecer contexto sobre o agente de maneira mais geral, fora do escopo do Container-Optimized OS.
- Documentação do pacote de operações do Google Cloud. Página inicial da documentação do pacote de operações do Google Cloud. Ela pode ser útil para contexto.