Encaminhar registros do Cloud Storage FUSE para o Cloud Logging

Este documento fornece instruções sobre como encaminhar registros do Cloud Storage FUSE para o Cloud Logging.

Os registros do Cloud Storage FUSE ajudam a entender como o Cloud Storage FUSE funciona e permitem solucionar problemas e monitorar o desempenho. Quando você usa a --log-severity opção ou o logging:severity campo para gerar registros, eles são gerados pelo Cloud Storage FUSE e podem ser visualizados como saída padrão ou arquivos de registro locais na máquina em que o Cloud Storage FUSE está em execução.

Também é possível encaminhar registros do Cloud Storage FUSE para o Cloud Logging, que oferece os seguintes benefícios:

  • Visualizar todos os registros do Cloud Storage FUSE em um único local no Cloud de Confiance console, que oferece uma visão geral do comportamento do Cloud Storage FUSE e facilita a correlação de eventos em diferentes componentes.

  • Filtrar registros do Cloud Storage FUSE por nível de gravidade, carimbo de data/hora, tipo de recurso e outros campos, o que pode ajudar a identificar erros ou problemas de desempenho.

  • Criar alertas baseados em métricas que são acionados por eventos de registro específicos. Por exemplo, é possível configurar um alerta para notificar você sempre que uma mensagem de registro error ou warning do Cloud Storage FUSE for detectada, permitindo que você reaja aos problemas de maneira proativa.

  • Armazenar registros no Cloud Logging por um período configurável e exportá-los para o Cloud Storage para armazenamento de longo prazo, arquivamento ou análise detalhada.

Preços

Para informações sobre preços do Cloud Logging, consulte Custos do Cloud Logging.

Acessar os papéis necessários

Para receber as permissões necessárias para usar o Cloud Logging e visualizar os registros do Cloud Storage FUSE, conceda o papel doIAM de Gravador de registros (roles/logging.logWriter) no projeto para o qual você quer coletar métricas.

Esse papel predefinido contém as permissões necessárias para usar o Cloud Logging. Para mais informações sobre o papel de Gravador de registros, consulte a documentação do IAM sobre roles/logging.logWriter.

Para instruções sobre como conceder papéis a projetos, consulte Gerenciar o acesso aos projetos.

Antes de começar

  1. Ative a API Cloud Storage.

    Acessar a API Cloud Storage

  2. Ative a API Cloud Logging.

    Acessar a API Cloud Logging

  3. Instale o Agente de operações do Cloud, que é o Cloud de Confiance by S3NS's principal agente para coletar registros e métricas. Selecione um método de instalação com base no tipo de máquina virtual que você está usando.

  4. Defina a gravidade da geração de registros como trace usando a opção --log-severity ou o campo severity como trace.

Encaminhar registros do Cloud Storage FUSE para o Cloud Logging

  1. Especifique /gcsfuse.log para sua montagem gcsfuse:

    logging:
  file-path: "/gcsfuse.log"
  severity: trace

  2. Configure o Agente de operações do Cloud para encaminhar registros do arquivo /gcfuse.log para o Cloud Logging usando a configuração a seguir. Nessa configuração, gcsfuse_trace_logs é um elemento receiver que recebe registros do arquivo /gcsfuse.log. O elemento service vincula o elemento receiver no pipeline.

    logging:
 receivers:
  gcsfuse_trace_logs:
  type: files
  include_paths:
  - /gcsfuse.log
service:
 pipelines:
   gcsfuse_pipeline:
     receivers: [gcsfuse_trace_logs]

    Para saber mais sobre outras configurações de geração de registros, consulte Configurações do Cloud Logging.

  3. Coloque a configuração do Agente de operações do Cloud em um caminho com base no seu sistema operacional. Para escolher o caminho em que a configuração será colocada, consulte a documentação do Google Cloud Observability para configurações especificadas pelo usuário.

  4. Reinicie o Agente de operações do Cloud para escolher novas mudanças de configuração usando o comando systemctl restart:

    sudo systemctl restart google-cloud-ops-agent`

  5. Acesse o Cloud Logging no Cloud de Confiance console.

  6. Execute a consulta de filtragem fuse_debug para validar os registros de rastreamento gcsfuse encaminhados para o Cloud Logging.

A seguir