Mostrar registros roteados para buckets do Cloud Logging

Neste documento, explicamos como encontrar entradas de registro roteadas para buckets do Cloud Logging. Os buckets de registros são contêineres de armazenamento do Cloud Logging nos projetos do Google Cloud que contêm os dados de registros. É possível criar coletores de registros para rotear todos ou apenas um subconjunto dos registros para qualquer bucket no Cloud Logging. Essa flexibilidade permite escolher em qual projeto do Google Cloud seus registros serão armazenados e quais outros registros serão armazenados com eles.

Os registros que você encaminha para os buckets do Cloud Logging ficam disponíveis imediatamente.

Para informações sobre como visualizar registros roteados para outros destinos, consulte os documentos a seguir:

Antes de começar

Para instruções sobre como criar e gerenciar buckets de registros, consulte os seguintes documentos:

Para uma discussão conceitual sobre coletores, consulte Visão geral dos modelos de roteamento e armazenamento: coletores.

Para instruções sobre como rotear seus registros, consulte Rotear registros para destinos compatíveis.

ver registros

Para solucionar problemas e visualizar entradas de registro individuais em um bucket de registros, faça o seguinte:

  1. No console do Google Cloud, acesse a página Análise de registros:

    Acessar a Análise de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Geração de registros.

  2. Na barra de ferramentas Ação, selecione Refinar escopo.
  3. Na caixa de diálogo Refinar escopo, selecione Escopo por armazenamento.

  4. Selecione um ou mais buckets de registros e clique em Aplicar.

    Para informações sobre como executar consultas, consulte Criar consultas na Análise de registros.

Para executar análises em entradas de registro armazenadas em um bucket de registros que é atualizado para usar a Análise de dados de registros, faça o seguinte:

  1. No console do Google Cloud, acesse a página Análise de dados de registros:

    Acessar a Análise de dados de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Geração de registros.

  2. Na lista Visualizações de registro, encontre a visualização e selecione Consulta. O painel Consulta é preenchido com uma consulta padrão, que inclui o nome da tabela consultada.

    Também é possível inserir uma consulta no painel Consulta ou editar uma consulta exibida.

    Para consultar todos os registros no bucket de registros, selecione a visualização _AllLogs.

  3. Na barra de ferramentas, clique em Executar consulta.

    A consulta é executada e o resultado dela é mostrado na guia Resultados.

    É possível usar as opções da barra de ferramentas para formatar a consulta, limpar a consulta e abrir a documentação de referência do SQL do BigQuery.

    Para informações sobre como executar consultas, acesse Consultar e visualizar registros na Análise de dados de registros.

Organização das entradas de registro

As entradas de registro do Logging são objetos do tipo LogEntry.

Entradas de registro com o mesmo tipo de registro, chamado de [LOG_ID] na referência LogEntry, geralmente têm o mesmo formato. Na tabela a seguir, há exemplos de entradas de registro:

syslog

O syslog do Compute Engine é um tipo de registro personalizado produzido pelo agente de registro google-fluentd, que é executado em instâncias de máquina virtual:

{
  logName: "projects/my-gcp-project-id/logs/syslog",
  timestamp: "2015-01-13T19:17:01Z",
  resource: {
    type: "gce_instance",
    labels: {
      instance_id: "12345",
      zone: "us-central1-a",
      project_id: "my-gcp-project-id"
    }
  },
  insertId: "abcde12345",
  textPayload: "Jan 13 19:17:01 my-gce-instance /USR/SBIN/CRON[29980]: (root) CMD (   cd / && run-parts --report /etc/cron.hourly)"
}

request_log

O App Engine request_log tem entradas de registro que contêm protoPayload campos com objetos do tipo RequestLog:

{
  logName: "projects/my-gcp-project-id/logs/appengine.googleapis.com%2Frequest_log",
  timestamp: "2015-01-13T19:00:39.796169Z",
  resource: {
    type: "gae_app",
    labels: {
      module_id: "default",
      zone: "us6",
      project_id: "my-gcp-project-id",
      version_id: "20150925t173233"
    }
  }
  httpRequest: {
    status: 200
  }
  insertId: "abcde12345",
  operation: {
    id: "abc123",
    producer: "appengine.googleapis.com/request_id",
    first: true,
    last: true
  }
  protoPayload: {
    @type: "type.googleapis.com/google.appengine.logging.v1.RequestLog"
    versionId: "20150925t173233",
    status: 200,
    startTime: "2017-01-13T19:00:39.796169Z",
    # ...
    appId: "s~my-gcp-project-id",
    appEngineRelease: "1.9.17",
  }
}

activity

O registro activity é um registro de auditoria das atividades do administrador. O payload dele é uma representação JSON do tipo AuditLog:

{
 logName: "projects/my-gcp-project-id/logs/cloudaudit.googleapis.com%2Factivity"
 timestamp: "2017-04-22T13:41:32.245Z"
 severity: "NOTICE"
 resource: {
  type: "gce_instance"
  labels: {
   instance_id: "2403273232180765234"
   zone: "us-central1-b"
   project_id: "my-gcp-project-id"
  }
 }
 insertId: "54DC1882F4B49.A4996C2.6A02F4C1"
 operation: {
  id: "operation-1492868454262-54dc185e9a4f0-249fe233-f73d472a"
  producer: "compute.googleapis.com"
  last: true
 }
 protoPayload: {
  @type: "type.googleapis.com/google.cloud.audit.AuditLog"
  authenticationInfo: {
   principalEmail: "649517127304@cloudservices.gserviceaccount.com"
  }
  requestMetadata: {…}
  serviceName: "compute.googleapis.com"
  methodName: "v1.compute.instances.delete"
  resourceName: "projects/my-gcp-project-id/zones/us-central1-b/instances/abc123"
 }
}

Solução de problemas

Se os registros não estiverem no destino do coletor ou se você suspeitar que o coletor não está roteando corretamente os registros, consulte Resolver problemas de roteamento e coletores.

Preços

O Cloud Logging não cobra para rotear registros para um destino compatível. No entanto, o destino pode aplicar cobranças. Com exceção do bucket de registros _Required, o Cloud Logging cobra pelo streaming de registros para buckets de registros e por um armazenamento maior que o período de armazenamento padrão do bucket de registros.

O Cloud Logging não cobra pela cópia de registros ou por consultas emitidas pela página Análise de registros ou pela página Análise de registros.

Para mais informações, consulte estes documentos: