Neste documento, explicamos como encontrar entradas de registro roteadas para os buckets do Cloud Logging. Os buckets de registros são contêineres de armazenamento do Cloud Logging nos seus projetos do Google Cloud que armazenam 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 os registros serão armazenados e quais outros registros são armazenados com elas.
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 seguintes documentos:
Antes de começar
Para instruções sobre como criar e gerenciar buckets de registros, consulte os seguintes documentos:
Para conferir 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:
-
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 Logging.
- Na barra de ferramentas Ação, selecione Refinar escopo.
- Na caixa de diálogo Refine scope, selecione Log view.
Selecione uma ou mais visualizações de registro e clique em Aplicar.
Para mais informações sobre como executar consultas, consulte Criar consultas na Análise de registros.
Para realizar análises em entradas de registro armazenadas em um bucket de registros que foi atualizado para usar a Análise de dados de registros, faça o seguinte:
-
No console do Google Cloud, acesse a página 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 Logging.
Na lista Visualizações de registro, encontre a visualização e selecione Consulta. O O painel Consulta é preenchido com uma consulta padrão, que inclui o visualização de registro que é consultada.
Também é possível inserir uma consulta no painel Consulta ou editar uma consulta exibida.
Para consultar todos os registros em um bucket de registros, selecione a visualização
_AllLogs
para o em um bucket de registros.Na barra de ferramentas, clique em Executar consulta.
A consulta é executada e o resultado dela é mostrado na guia Resultados.
Você pode usar as opções da barra de ferramentas para formatar, limpar a consulta e abrir a documentação de referência do SQL do BigQuery.
Para mais informações sobre como executar consultas, consulte 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, chamadas de [LOG_ID]
no
Referência do LogEntry
, geralmente têm o mesmo formato. Na tabela a seguir, há exemplos de entradas de registro:
syslog
Veja a seguir um exemplo de syslog
do Compute Engine:
{
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 registro que contêm protoPayload
campos com 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"
}
}
activity
O registro activity
é um registro de auditoria das atividades do administrador.
O payload dele é 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"
}
Solução de problemas
Se faltarem registros no destino do coletor ou se você suspeitar se o coletor não está roteando corretamente os registros, consulte Resolver problemas com roteamento e coletores
Preços
O Cloud Logging não cobra pelo roteamento de registros para um
destino com suporte No entanto, o destino pode aplicar cobranças.
Com exceção do bucket de registros _Required
,
O Cloud Logging cobra para transmitir registros para buckets de registros e
para 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, para definir escopos de registro; ou consultas emitidas pela páginas Análise de registros ou Análise de registros.
Para mais informações, consulte estes documentos:
- Resumo dos preços do Cloud Logging
Custos de destino:
- Cobranças da geração de registros de fluxo de VPC são aplicadas quando você envia e exclui os registros de fluxo da nuvem privada virtual do Cloud Logging.