\google\appengine\api\log\LogService

FINAL

LogService permite que una aplicación consulte registros de solicitudes y de aplicaciones. Los registros de la aplicación se agregan al registro de solicitudes actual mediante una llamada a {@link http://php.net/manual/en/function.syslog.php syslog(int $priority, string $message)}. La $priority que se usa cuando se crea el registro de la aplicación se traduce en una escala de gravedad diferente que usa LogService según las siguientes asignaciones:

  • LOG_DEBUG => LogService::LEVEL_DEBUG
  • LOG_INFO => LogService::LEVEL_INFO
  • LOG_NOTICE => LogService::LEVEL_INFO
  • LOG_WARNING => LogService::LEVEL_WARNING
  • LOG_ERR => LogService::LEVEL_ERROR
  • LOG_CRIT => LogService::LEVEL_CRITICAL
  • LOG_ALERT => LogService::LEVEL_CRITICAL
  • LOG_EMERG => LogService::LEVEL_CRITICAL

Cuando recuperes registros de aplicación o filtres registros de solicitud por gravedad, usa los niveles de gravedad de LogService.

Usa rasgos

\google\appengine\api\log\ApiProxyAccess

Constantes

LEVEL_DEBUG

Constantes para los niveles de registro de la aplicación.

LEVEL_INFO

LEVEL_WARNING

LEVEL_ERROR

LEVEL_CRITICAL

MAX_BATCH_SIZE

La cantidad máxima de registros de solicitudes que se muestran en cada lote.

Métodos

fetch

STATIC   

fetch(array $options = array()) : \google\appengine\api\log\Iterator

Obtén registros de solicitudes que coincidan con las opciones determinadas en orden cronológico inverso de la hora de finalización de la solicitud.

Parámetros

Nombre Descripción

$options

array

Array asociativo opcional de filtros y modificadores de los siguientes elementos:

  • 'start_time': DateTime or numeric La hora de finalización más temprana o la hora de la última actualización de los registros de solicitudes. Si el valor es numérico, representa microsegundos desde la época Unix.
  • “end_time”: DateTime or numeric La hora de finalización más reciente o la hora de la última actualización de los registros de solicitudes. Si el valor es numérico, representa microsegundos desde la época Unix.
  • “offset”: string El valor de compensación seguro para URL de un RequestLog para continuar iterando después.
  • “minimum_log_level”:integer Solo muestra registros de solicitudes que contengan al menos un registro de aplicación de esta gravedad o superior. Funciona incluso si include_app_logs no es true
  • “include_incomplete”: boolean Si se deben incluir registros de solicitud incompletos. El valor predeterminado es false; solo se muestran los registros completados.
  • “include_app_logs”: boolean Si se deben mostrar registros de aplicaciones. El valor predeterminado es false: los registros de la aplicación no se muestran con los registros de solicitud que los contienen.
  • “versions”: array Las versiones del módulo predeterminado para las que se deben recuperar los registros de solicitudes. Solo se puede usar uno de “versions" o “module_versions”.
  • “module_versions”: arrary Un array asociativo de nombres de módulos a versiones para las que se deben recuperar los registros de solicitud. Cada nombre de módulo puede asignarse a una sola versión string o un array de versiones.
  • “batch_size”: integer La cantidad de registros de solicitudes para la recuperación previa durante la iteración.

Muestra

\google\appengine\api\log\Iterator

Los elementos RequestLog que coinciden.

fetchById

STATIC   

fetchById(mixed $request_ids, boolean $include_app_logs = true) : array<mixed,\google\appengine\api\log\RequestLog>

Obtén registros de solicitudes para los IDs de registro de solicitudes determinados y, opcionalmente, incluye los registros de la aplicación que se agregaron durante cada solicitud. Los IDs de registro de solicitud que no se encuentran se ignoran, por lo que el array que se muestra puede tener menos elementos que $request_ids.

Parámetros

Nombre Descripción

$request_ids

mixed

Un ID de solicitud de string o un array de IDs de solicitud de string obtenidos de RequestLog::getRequestId().

$include_app_logs

boolean

Si los registros de aplicación se deben incluir en los registros de solicitud recuperados. La configuración predeterminada es verdadera: se incluyen los registros de la aplicación.

Muestra

array<mixed,\google\appengine\api\log\RequestLog>

Los registros de solicitud de IDs que se encontraron.

log

STATIC   

log(integer $severity, string $message)

Agrega un registro de aplicación en un nivel de gravedad particular de Google App Engine.

Parámetros

Nombre Descripción

$severity

integer

El nivel de gravedad de Google App Engine para el registro.

$message

string

El mensaje que se registrará.

vaciar

STATIC   

flush()

Escribe todos los mensajes de registro almacenados en búfer en el almacenamiento de registros. Es posible que los registros no estén disponibles de inmediato para leerlos.

setAutoFlushEntries

STATIC   

setAutoFlushEntries(integer $entries)

Establece la cantidad máxima de entradas de registro que se almacenará en búfer antes de que se vacíen de forma automática después de agregar la siguiente entrada de registro.

Parámetros

Nombre Descripción

$entries

integer

Cantidad de entradas de registro en búfer.

setAutoFlushBytes

STATIC   

setAutoFlushBytes(integer $bytes)

Establece el tamaño máximo de los registros en el búfer antes de que se borren de forma automática cuando se agregue la siguiente entrada de registro.

Parámetros

Nombre Descripción

$bytes

integer

Tamaño de los registros que se almacenarán en búfer en bytes.

setLogFlushTimeLimit

STATIC   

setLogFlushTimeLimit(integer $seconds)

Establece la cantidad máxima de tiempo en segundos antes de que los registros almacenados en búfer se limpien de forma automática cuando se agrega la siguiente entrada de registro.

Parámetros

Nombre Descripción

$seconds

integer

Tiempo en segundos. Usa un valor negativo o cero para inhabilitar el límite de tiempo.

getAppEngineLogLevel

STATIC   

getAppEngineLogLevel(integer $syslog_level) : integer

Traduce un nivel de prioridad syslog de PHP a un nivel de gravedad de Google App Engine. Es útil para filtrar registros según el nivel de gravedad mínimo según el nivel de syslog.

Parámetros

Nombre Descripción

$syslog_level

integer

El nivel de prioridad que se pasa a syslog.

Muestra

integer

El nivel de gravedad de App Engine.