Este documento explica como pode encontrar entradas de registo que encaminhou do Cloud Logging para contentores do Cloud Storage.
As entradas de registo são guardadas em contentores do Cloud Storage em lotes por hora. Pode demorar entre 2 e 3 horas até que as primeiras entradas comecem a aparecer.
Antes de começar
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 seus registos, consulte o artigo Encaminhe registos para destinos suportados.
Ver registos
Para ver os registos encaminhados para o Cloud Storage, faça o seguinte:
-
Na Google Cloud consola, aceda à página Recipientes:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Cloud Storage.
Selecione o contentor do Cloud Storage que está a usar como destino de encaminhamento.
Organização dos registos
Quando encaminha registos para um contentor do Cloud Storage, o Logging escreve um conjunto de ficheiros no contentor.
Os ficheiros são organizados em hierarquias de diretórios por tipo de registo e data. O tipo de registo, referido como [LOG_ID] na referência LogEntry, pode ser um nome simples, como syslog, ou um nome composto, como appengine.googleapis.com/request_log. Se estes registos fossem armazenados num contentor
denominado my-gcs-bucket,
os diretórios seriam denominados como no exemplo seguinte:
my-gcs-bucket/syslog/YYYY/MM/DD/
my-gcs-bucket/appengine.googleapis.com/request_log/YYYY/MM/DD/
Um único contentor do Cloud Storage pode conter registos de vários tipos de recursos. O tamanho máximo do ficheiro é de 3,5 GiB.
O registo não garante a remoção de duplicados de entradas de registo de destinos que contenham consultas idênticas ou sobrepostas. As entradas de registo desses destinos podem ser escritas várias vezes num contentor do Cloud Storage.
Os diretórios de folhas (DD/) contêm vários ficheiros, cada um dos quais contém as entradas de registo encaminhadas para um período especificado no nome do ficheiro. Os ficheiros são divididos e os respetivos nomes terminam num número de divisão, Sn ou An (n=0, 1, 2, ...). Por exemplo, seguem-se dois ficheiros que podem ser armazenados no diretório my-gcs-bucket/syslog/2015/01/13/:
08:00:00_08:59:59_S0.json 08:00:00_08:59:59_S1.json
Estes dois ficheiros contêm em conjunto as entradas de registo de todas as instâncias durante a hora que começa às 08:00:00 UTC e termina às 08:59:59 UTC.syslog As indicações de tempo da entrada do registo são expressas em UTC (Tempo Universal Coordenado).
As entradas de registo que chegam com um receiveTimestamp
no período alinhado de 60 minutos do respetivo timestamp são escritas em ficheiros do fragmento principal. Por exemplo, uma entrada de registo com um timestamp de 08:00:00
e um receiveTimestamp de 08:10:00 é armazenada no ficheiro de fragmento principal.
Estes ficheiros incluem um fragmento principal numerado no sufixo:
_Sn.json.
As entradas de registo que chegam com um timestamp numa janela alinhada de 60 minutos diferente do respetivo receiveTimestamp são escritas em ficheiros addendum shard. Por exemplo, uma entrada de registo com um timestamp de 08:00:00 e um receiveTimestamp de 09:10:00 é armazenada num ficheiro de fragmento de anexo.
Estes ficheiros incluem um fragmento de anexo numerado com o sufixo: _An:Unix_timestamp.json.
Por exemplo, uma entrada de registo que tenha um timestamp entre as 08:00:00 e as
08:59:59, mas um receiveTimestamp numa janela alinhada de 60 minutos diferente, é escrita num ficheiro com o sufixo _An:Unix_timestamp.json, em que a data/hora Unix identifica a hora em que o ficheiro foi encaminhado para o
Cloud Storage. Se uma entrada de registo tiver um timestamp de 08:50:00 e um receiveTimestamp de 09:10:00, e tiver sido encaminhada às 09:15:00 a 25 de março de 2021, o ficheiro de adenda seria escrito da seguinte forma:
08:00:00_08:59:59_A0:1616681700.json
Para obter todas as entradas do registo, tem de ler todos os fragmentos para cada período. Neste caso, os fragmentos de ficheiros 0 e 1. O número de fragmentos de ficheiros escritos pode mudar para cada período.
Nos ficheiros fragmentados individuais, as entradas de registo são armazenadas como uma lista de objetos LogEntry. Para ver um exemplo de uma entrada syslog, consulte a secção
Organização das entradas do registo.
Tenha em atenção que a ordem de ordenação das entradas de registo nos ficheiros não é uniforme nem garantida de outra forma.
Entradas do registo com atraso
As entradas de registo encaminhadas são guardadas em contentores do Cloud Storage em lotes por hora.
As primeiras entradas podem demorar entre 2 e 3 horas a aparecer. Os fragmentos de ficheiros de registo encaminhados com o sufixo An
("Append") contêm entradas de registo que chegaram tarde.
Se o destino sofrer uma indisponibilidade, o Cloud Logging armazena em buffer os dados até a indisponibilidade terminar.
Se não existirem registos no destino do coletor, verifique as métricas do sistema de exportação. As métricas do sistema de exportação indicam quantas entradas de registo são encaminhadas e quantas são ignoradas devido a erros. Se as métricas do sistema de exportação indicarem que não foram encaminhadas entradas de registo para o destino, verifique o [filtro][export-query] para confirmar se as entradas de registo correspondentes ao seu filtro chegaram recentemente ao Logging.
Na Google Cloud consola, aceda à página Log Router:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.
Entradas de registo do App Engine
O App Engine combina várias subentradas do tipo
google.appengine.logging.v1.LogLine (também denominadas AppLog ou
AppLogLine) numa entrada de registo principal do tipo
google.appengine.logging.v1.RequestLog para o pedido
que causa a atividade de registo. Cada linha do registo tem um "ID do pedido" que identifica a entrada principal. O Explorador de registos apresenta as linhas de registo com a entrada do registo de pedidos. O registo tenta colocar todas as linhas de registo no lote com o pedido original, mesmo que as respetivas datas/horas as coloquem no lote seguinte. Se isso não for possível, a entrada do registo de pedidos pode não ter algumas linhas do registo e podem existir linhas do registo "órfãs" sem um pedido no lote seguinte. Se esta possibilidade for importante para si, prepare-se para voltar a associar as partes do pedido quando processar os registos.
Resolução de problemas
Se os registos parecerem estar em falta no destino do seu coletor ou suspeitar que o coletor não está a encaminhar corretamente os registos, consulte o artigo Resolva problemas de encaminhamento de registos.
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:
- As secções do Cloud Logging na página de preços da observabilidade do Google Cloud.
Custos quando encaminha dados de registo de encaminhamento para outros Google Cloud serviços:
- As taxas de geração de registos de fluxo da VPC aplicam-se quando envia e, em seguida, exclui os registos de fluxo da nuvem virtual privada do Cloud Logging.