Veja registos encaminhados para contentores do Cloud Logging

Este documento explica como pode encontrar entradas de registo que encaminhou para contentores do Cloud Logging. Os contentores de registos são contentores de armazenamento do Cloud Logging nos seus Google Cloud projetos que contêm os dados dos registos. Pode criar destinos de registos para encaminhar todos os registos ou apenas um subconjunto dos mesmos para qualquer contentor no Cloud Logging. Esta flexibilidade permite-lhe escolher em que projeto do Google Cloud os seus registos são armazenados e que outros registos são armazenados com eles.

Os registos que encaminha para contentores do Cloud Logging estão disponíveis imediatamente.

Para ver informações sobre a visualização de registos encaminhados para outros destinos, consulte os seguintes documentos:

Antes de começar

Para instruções sobre como criar e gerir contentores de registos, consulte os seguintes documentos:

Para uma discussão conceptual sobre os destinos, consulte o artigo Vista geral dos modelos de encaminhamento e armazenamento: destinos.

Para ver instruções sobre como encaminhar os registos, consulte o artigo Encaminhe registos para destinos suportados.

Ver registos

Para resolver problemas e ver entradas de registo individuais num contentor de registos, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Explorador de registos:

    Aceda ao Explorador de registos

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

  2. Na barra de ferramentas Ação, selecione Refinar âmbito.
  3. Na caixa de diálogo Refinar âmbito, selecione Vista de registo.

  4. Selecione uma ou mais vistas de registo e, de seguida, clique em Aplicar.

    Para obter informações sobre como executar consultas, consulte o artigo Crie consultas no Explorador de registos.

Para realizar a análise das entradas do registo armazenadas num contentor de registos atualizado para usar o Log Analytics, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Log Analytics:

    Aceda ao Log Analytics

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

  2. Na lista Ver registos, encontre a visualização e, de seguida, selecione Consultar. O painel Consulta é preenchido com uma consulta predefinida, que inclui a visualização de registo consultada.

    Também pode introduzir uma consulta no painel Consulta ou editar uma consulta apresentada.

    Para consultar todos os registos num contentor de registos, selecione a vista _AllLogs para o contentor de registos.

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

    A consulta é executada e o resultado da consulta é apresentado no separador Resultados.

    Pode 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 ver informações sobre como executar consultas, consulte o artigo Consultar e ver registos no Log Analytics.

Organização das entradas do registo

As entradas de registo de registo são objetos do tipo LogEntry.

As entradas de registo com o mesmo tipo de registo, referidas como [LOG_ID] na referência LogEntry, têm normalmente o mesmo formato. A tabela seguinte mostra exemplos de entradas do registo:

syslog

Segue-se um exemplo de um Compute Engine syslog:

{
  insertId: "4zymupf98ac6v"
  jsonPayload: {
    message: "Jul 15 13:36:33 my-instance dhclient[328]: DHCPACK of 10.240.0.48 from 169.254.169.254"
  }
  logName: "projects/my-gcp-project-id/logs/syslog"
  receiveTimestamp: "2024-07-15T13:36:33.400534415Z"
  resource: {
    labels: {
      instance_id: "0123456789" (instance_name: my-instance)
      project_id: "my-gcp-project-id"
      zone: "us-central1-a"
    }
    type: "gce_instance"
  }
  timestamp: "2024-07-15T13:36:33.097822178Z"
}

request_log

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

{
  httpRequest: {
    status: 200
  }
  insertId: "669525c0000d39d1eab2bb03"
  labels: {1}
  logName: "projects/my-gcp-project-id/logs/appengine.googleapis.com%2Frequest_log"
  operation: {4}
  protoPayload: {
    @type: "type.googleapis.com/google.appengine.logging.v1.RequestLog"
    appEngineRelease: "1.9.71"
    appId: "s~my-gcp-project-id"
    startTime: "2024-07-15T13:36:00.861387Z"
    ...
  }
  receiveTimestamp: "2024-07-15T13:36:01.169966997Z"
  resource: {2}
  spanId: "7925702051311044593"
  timestamp: "2024-07-15T13:36:00.861387Z"
  trace: "projects/my-gcp-project-id/traces/8a4fab4bd4fbafac2a0fa901c1485847"
  resource: {
    labels: {
      module_id: "default"
      project_id: "my-gcp-project-id"
      version_id: "20200221t133337"
      zone: "us14"
    }
    type: "gae_app"
  }
}

atividade

O registo activity é um registo de auditoria da atividade do administrador. O respetivo payload é uma representação JSON do tipo: AuditLog 

{
  insertId: "dlu8qwc69c"
  labels: {
    compute.googleapis.com/root_trigger_id: "a97f30b1-45ab-4c12-9309-8e8af3bb011f"
  }
  logName: "projects/my-gcp-project-id/logs/cloudaudit.googleapis.com%2Factivity"
  operation: {
    id: "operation-1721047950764-61d48b3bf2b65-1ba1f256-82e9b5fd"
    last: true
    producer: "compute.googleapis.com"
  }
  protoPayload: {
    @type: "type.googleapis.com/google.cloud.audit.AuditLog"
    authenticationInfo: {...}
    methodName: "v1.compute.instances.insert"
    request: {...}
    requestMetadata: {...}
    resourceName: "projects/my-gcp-project-id/zones/us-central1-f/instances/my-instance"
    serviceName: "compute.googleapis.com"
  }
  receiveTimestamp: "2024-07-15T12:52:41.376292847Z"
  resource: {
  labels: {
    instance_id: "2891866457752773984" (instance_name: my-instance)
    project_id: "my-gcp-project-id"
    zone: "us-central1-f"
    }
    type: "gce_instance"
  }
  severity: "NOTICE"
  timestamp: "2024-07-15T12:52:40.965840Z"
}

Resolução de problemas

Se os registos parecerem estar em falta no destino do coletor ou suspeitar que o coletor não está a encaminhar corretamente os registos, consulte o artigo Resolva problemas de encaminhamento e coletores.

Preços

O Cloud Logging não cobra o encaminhamento de registos para um destino suportado. No entanto, o destino pode aplicar cobranças. Com exceção do contentor de registos _Required, o Cloud Logging cobra taxas para transmitir registos para contentores de registos e para armazenamento durante um período superior ao período de retenção predefinido do contentor de registos.

O Cloud Logging não cobra pela cópia de registos, pela criação de âmbitos de registo ou vistas de estatísticas, nem por consultas emitidas através das páginas do Explorador de registos ou Log Analytics.

Para mais informações, consulte os seguintes documentos: