En este documento se explica cómo puedes encontrar entradas de registro que hayas enrutado desde Cloud Logging a segmentos de Cloud Storage.
Las entradas de registro se guardan en segmentos de Cloud Storage en lotes por horas. Las primeras entradas pueden tardar entre 2 y 3 horas en aparecer.
Antes de empezar
Para obtener información conceptual sobre los receptores, consulta Descripción general de los modelos de enrutamiento y almacenamiento: receptores.
Para obtener instrucciones sobre cómo enrutar los registros, consulta Enrutar registros a destinos admitidos.
Ver registros
Para ver los registros que se han enrutado a Cloud Storage, haz lo siguiente:
-
En la Google Cloud consola, ve a la página Segmentos:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo sea Cloud Storage.
Selecciona el segmento de Cloud Storage que estés usando como destino de enrutamiento.
Organización de los registros
Cuando enruta registros a un segmento de Cloud Storage, Logging escribe un conjunto de archivos en el segmento.
Los archivos se organizan en jerarquías de directorios por tipo de registro y fecha. El tipo de registro, al que se hace referencia como [LOG_ID] en la referencia de LogEntry, puede ser un nombre sencillo, como syslog, o un nombre compuesto, como appengine.googleapis.com/request_log. Si estos registros se almacenaran en un contenedor llamado my-gcs-bucket,
los directorios se llamarían como en el siguiente ejemplo:
my-gcs-bucket/syslog/YYYY/MM/DD/
my-gcs-bucket/appengine.googleapis.com/request_log/YYYY/MM/DD/
Un mismo segmento de Cloud Storage puede contener registros de varios tipos de recursos. El tamaño máximo del archivo es de 3,5 GiB.
El registro no garantiza la eliminación de duplicados de las entradas de registro de los receptores que contengan consultas idénticas o superpuestas. Es posible que las entradas de registro de esos receptores se escriban varias veces en un segmento de Cloud Storage.
Los directorios hoja (DD/) contienen varios archivos, cada uno de los cuales incluye las entradas de registro de la ruta de un periodo especificado en el nombre del archivo. Los archivos se fragmentan y sus nombres terminan en un número de fragmento,
Sn o An (n=0, 1, 2,
...). Por ejemplo, estos son dos archivos que se pueden almacenar en el directorio
my-gcs-bucket/syslog/2015/01/13/:
08:00:00_08:59:59_S0.json 08:00:00_08:59:59_S1.json
Estos dos archivos contienen las entradas de registro de syslog
de todas las instancias durante la hora que empieza a las 08:00:00 (UTC) y termina a las
08:59:59 (UTC). Las marcas de tiempo de las entradas de registro se expresan en UTC (tiempo universal coordinado).
Las entradas de registro que llegan con un receiveTimestamp dentro del periodo de 60 minutos alineado de su timestamp se escriben en archivos de fragmento principal. Por ejemplo, una entrada de registro con un timestamp de las 08:00:00 y un receiveTimestamp de las 08:10:00 se almacena en el archivo de fragmento principal.
Estos archivos incluyen un fragmento principal numerado en el sufijo:
_Sn.json.
Las entradas de registro que llegan con un timestamp en un periodo de 60 minutos distinto al de su receiveTimestamp se escriben en archivos de fragmento de anexos. Por ejemplo, una entrada de registro con un timestamp de las 08:00:00 y un receiveTimestamp de las 09:10:00 se almacena en un archivo de fragmento de addendum.
Estos archivos incluyen un fragmento de adenda numerado con el sufijo _An:Unix_timestamp.json.
Por ejemplo, una entrada de registro que tenga un timestamp entre las 08:00:00 y las 08:59:59, pero un receiveTimestamp en otra ventana alineada de 60 minutos, se escribe en un archivo con el sufijo _An:Unix_timestamp.json, donde la marca de tiempo Unix identifica la hora a la que se ha enviado el archivo a Cloud Storage. Si una entrada de registro tenía un timestamp de las 08:50:00 y un receiveTimestamp de las 09:10:00, y se enrutó a las 09:15:00 del 25 de marzo del 2021, el archivo de adenda se escribiría de la siguiente manera:
08:00:00_08:59:59_A0:1616681700.json
Para obtener todas las entradas de registro, debes leer todos los fragmentos de cada periodo. En este caso, los fragmentos de archivo 0 y 1. El número de particiones de archivos escritas puede cambiar en cada periodo.
En los archivos fragmentados individuales, las entradas de registro se almacenan como una lista de objetos LogEntry. Para ver un ejemplo de una entrada syslog, consulta Organización de las entradas de registro.
Ten en cuenta que el orden de clasificación de las entradas de registro en los archivos no es uniforme ni está garantizado.
Entradas de registro que llegan tarde
Las entradas de registro enrutadas se guardan en segmentos de Cloud Storage en lotes por horas.
Las primeras entradas pueden tardar entre 2 y 3 horas en aparecer. Los fragmentos de archivos de registro enrutados con el sufijo An
("Append") contienen entradas de registro que han llegado tarde.
Si el destino sufre una interrupción, Cloud Logging almacenará en búfer los datos hasta que se solucione.
Si no hay ningún registro en el destino del receptor, consulta las métricas del sistema de exportación. Las métricas del sistema de exportación indican cuántas entradas de registro se enrutan y cuántas se descartan debido a errores. Si las métricas del sistema de exportación indican que no se ha dirigido ninguna entrada de registro al destino, comprueba tu [filtro][export-query] para verificar que las entradas de registro que coinciden con tu filtro han llegado recientemente a Logging.
En la Google Cloud consola, ve a la página Enrutador de registros:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.
Entradas de registro de App Engine
App Engine combina varias subentradas de tipo google.appengine.logging.v1.LogLine (también llamadas AppLog o AppLogLine) en una entrada de registro principal de tipo google.appengine.logging.v1.RequestLog para la solicitud que provoca la actividad de registro. Cada línea de registro tiene un "ID de solicitud" que identifica la entrada principal. El Explorador de registros muestra las líneas de registro con la entrada de registro de la solicitud. Registra los intentos para incluir todas las líneas de registro en el lote con la solicitud original, aunque sus marcas de tiempo las coloquen en el siguiente lote. Si no es posible, es posible que falten algunas líneas de registro en la entrada del registro de solicitudes y que haya líneas de registro "huérfanas" sin una solicitud en el siguiente lote. Si esta posibilidad es importante para ti, prepárate para volver a conectar las partes de la solicitud cuando proceses tus registros.
Solución de problemas
Si parece que faltan registros en el destino de tu receptor o sospechas que no está enrutando los registros correctamente, consulta Solucionar problemas con el enrutamiento de registros.
Precios
Cloud Logging no cobra por enrutar registros a un destino compatible, pero es posible que el destino aplique cargos.
A excepción del segmento de registros _Required, Cloud Logging cobra por transmitir registros a los segmentos de registros y por el almacenamiento que supere el periodo de conservación predeterminado del segmento de registros.
Cloud Logging no cobra por copiar registros, crear ámbitos de registro ni vistas de analíticas, ni por las consultas enviadas a través de las páginas Explorador de registros o Analíticas de registros.
Para obtener más información, consulte los documentos siguientes:
- Las secciones de Cloud Logging de la página Precios de Observabilidad de Google Cloud.
Costes al enrutar datos de registro a otros servicios: Google Cloud
- Se aplican cargos por generar registros de flujo de VPC cuando envías y luego excluyes tus registros de flujo de nube privada virtual de Cloud Logging.