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, resolver problemas e monitorar o desempenho. Ao gerar registros usando a opção --log-severity ou o campo logging:severity, é possível visualizá-los como saída padrão ou em arquivos de registro locais na máquina em que o Cloud Storage FUSE é executado. O encaminhamento desses registros para o Cloud Logging permite visualizar, filtrar, alertar e retê-los em um local central.

Neste documento, descrevemos como encaminhar registros do Cloud Storage FUSE para o Cloud Logging.

Benefícios de encaminhar registros para o Cloud Logging

Ao encaminhar registros do Cloud Storage FUSE para o Cloud Logging, é possível fazer o seguinte:

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

  • Filtrar os 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 com base 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.

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

Preços

Para informações sobre os 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 para visualizar os registros do Cloud Storage FUSE, conceda o papel do IAM de Gravador de registros (roles/logging.logWriter) no projeto em que 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 Storage do Cloud Storage.

    Acessar a API Cloud Storage

  2. Ative a API Cloud Logging.

    Acesse a API Cloud Logging

  3. Instale o Agente de Operações do Cloud, que é o principal agente do Cloud de Confiance by S3NSpara 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 a 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 aplicar as novas alterações de configuração usando o comando systemctl restart:

    sudo systemctl restart google-cloud-ops-agent`

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

  6. Execute a consulta de filtragem fuse_debug para validar os registros de trace gcsfuse que são encaminhados para o Cloud Logging.

A seguir