Encaminhe os registos do FUSE do Cloud Storage para o Cloud Logging

Esta página fornece instruções sobre como encaminhar registos do FUSE do Cloud Storage para o Cloud Logging.

Vista geral

Os registos do FUSE do Cloud Storage ajudam a compreender como o FUSE do Cloud Storage funciona e permitem-lhe resolver problemas e monitorizar o desempenho. Quando usa a opção --log-severity ou o campo logging:severity para gerar registos, os registos são gerados pelo Cloud Storage FUSE e podem ser vistos como saída padrão ou ficheiros de registo locais na máquina onde o Cloud Storage FUSE está em execução.

Também pode encaminhar os registos do FUSE do Cloud Storage para o Cloud Logging, o que oferece as seguintes vantagens:

  • Veja todos os registos do FUSE do Cloud Storage numa única localização na Google Cloud consola, que oferece uma vista holística do comportamento do FUSE do Cloud Storage e facilita a correlação de eventos em diferentes componentes.

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

  • Crie alertas baseados em métricas que são acionados por eventos de registo específicos. Por exemplo, pode configurar um alerta para receber uma notificação sempre que for detetada uma mensagem de registo error ou warning do Cloud Storage FUSE, o que lhe permite reagir aos problemas de forma proativa.

  • Armazenar registos no Cloud Logging durante um período configurável e exportá-los para o Cloud Storage para armazenamento a longo prazo, arquivo ou análise detalhada.

Preços

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

Obtenha as funções necessárias

Para receber as autorizações necessárias para usar o Cloud Logging para ver os registos do Cloud Storage FUSE, conceda a função do IAM Logs Writer (roles/logging.logWriter) no projeto para o qual quer recolher métricas.

Esta função predefinida contém as autorizações necessárias para usar o Cloud Logging. Para mais informações sobre a função Logs Writer, consulte a documentação do IAM sobre roles/logging.logWriter.

Para obter instruções sobre como conceder funções para projetos, consulte o artigo Gerir o acesso a projetos.

Antes de começar

  1. Ative a API Cloud Storage.

    Aceda à API Cloud Storage

  2. Ative a Cloud Logging API.

    Aceda à Cloud Logging API

  3. Instale o Cloud Ops Agent, que é o agente principal para recolher registos e métricas. Google CloudSelecione um método de instalação com base no tipo de máquina virtual que está a usar.

  4. Defina a gravidade do registo como trace através da opção --log-severity ou do campo severity como trace.

Encaminhe os registos do FUSE do Cloud Storage para o Cloud Logging

  1. Especifique /gcsfuse.log para o suporte gcsfuse:

    logging:
      file-path: "/gcsfuse.log"
      severity: trace
    
  2. Configure o Cloud Ops Agent para encaminhar registos do ficheiro /gcfuse.log para o Cloud Logging através da seguinte configuração. Nesta configuração, o elemento gcsfuse_trace_logs é um elemento receiver que recebe registos do ficheiro /gcsfuse.log. O elemento service associa 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 as configurações de registo adicionais, consulte as configurações do Cloud Logging.

  3. Coloque a configuração do agente de operações na nuvem num caminho com base no seu sistema operativo. Para escolher o caminho onde colocar a configuração, consulte a documentação do Google Cloud Observability para configurações especificadas pelo utilizador.

  4. Reinicie o Cloud Ops Agent para aplicar as novas alterações de configuração com o comando systemctl restart:

    sudo systemctl restart google-cloud-ops-agent`
    
  5. Aceda ao Cloud Logging na Google Cloud consola.

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

O que se segue?