\google\appengine\api\log\LogService

FINAL

Com o LogService, o aplicativo pode consultar os registros de solicitações e aplicativos. Os registros do aplicativo são adicionados a um registro de solicitação atual por uma chamada a {@link http://php.net/manual/en/function.syslog.php syslog (int $priority, string $message)}. O $priority usado na criação do registro do aplicativo é convertido em uma escala de gravidade diferente usada por LogService com base nos seguintes mapeamentos:

  • 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

Ao buscar os registros do aplicativo ou filtrar os registros de solicitação por gravidade, use os níveis de gravidade do LogService.

Uso de traços

\google\appengine\api\log\ApiProxyAccess

Constantes

LEVEL_DEBUG

Constantes para os níveis de registro do aplicativo.

LEVEL_INFO

LEVEL_WARNING

LEVEL_ERROR

LEVEL_CRITICAL

MAX_BATCH_SIZE

O número máximo de registros de solicitação retornados em cada lote.

Métodos

fetch

STATIC   

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

Receba registros de solicitações que correspondam às opções fornecidas em ordem cronológica inversa do horário de término da solicitação.

Parâmetros

Nome Descrição

$options

array

Matriz associativa opcional de filtros e modificadores de:

  • "start_time": DateTime or numeric o horário de conclusão mais recente ou o horário da última atualização dos registros de solicitação. Se o valor for numérico, ele representará microssegundos desde o início da Era Unix.
  • "end_time": DateTime or numeric o horário da conclusão mais recente ou o horário da última atualização dos registros de solicitação. Se o valor for numérico, ele representará microssegundos desde o início da Era Unix.
  • "offset": string o valor de deslocamento seguro do URL de um RequestLog para continuar a iteração após.
  • "minimum_log_level": integer retorna apenas registros de solicitação que contenham pelo menos um registro de aplicativos com essa gravidade ou superior. Funciona mesmo quando include_app_logs não é true.
  • "include_incomplete": boolean precisa incluir registros de solicitação incompletos. O padrão é false: somente os registros concluídos são retornados
  • "include_app_logs": boolean precisa retornar registros do aplicativo. O padrão é false: os registros de aplicativos não são retornados com os registros de solicitação que os contêm.
  • "versions": array as versões do módulo padrão em que os registros de solicitação serão buscados. Apenas uma das "versions" e "module_versions" pode ser usada.
  • "module_versions": arrary uma matriz associativa de nomes de módulos para versões que buscam os registros de solicitações. Cada nome de módulo pode ser mapeado para uma única versão string ou para uma array de versões.
  • "batch_size": integer o número de registros de solicitação a serem pré-buscados durante a iteração.

Retorna

\google\appengine\api\log\Iterator

Os itens de RequestLog correspondentes.

fetchById

STATIC   

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

Receba registros de solicitações para os IDs fornecidos e, opcionalmente, inclua os registros de aplicativos adicionados durante cada solicitação. Os IDs de registros de solicitação não encontrados são ignorados, portanto, a matriz retornada pode ter menos itens que $request_ids.

Parâmetros

Nome Descrição

$request_ids

mixed

Um ID de solicitação de string ou uma matriz de IDs de solicitação de string recebidos de RequestLog::getRequestId().

$include_app_logs

boolean

Os registros de aplicativos precisam ser incluídos nos registros de solicitações buscadas. O padrão é "true". Os registros do aplicativo são incluídos.

Retorna

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

Os registros de solicitação para IDs encontrados.

log

STATIC   

log(integer $severity, string $message)

Adicione um registro de aplicativo em um nível de gravidade específico do Google App Engine.

Parâmetros

Nome Descrição

$severity

integer

O nível de gravidade do Google App Engine para o registro.

$message

string

A mensagem a ser registrada.

transferir

STATIC   

flush()

Grave todas as mensagens de registro em buffer no armazenamento de registros. Os registros podem não estar imediatamente disponíveis para leitura.

setAutoFlushEntries

STATIC   

setAutoFlushEntries(integer $entries)

Defina o número máximo de entradas de registro para buffer antes da transferência automática ao adicionar a próxima entrada de registro.

Parâmetros

Nome Descrição

$entries

integer

Número de entradas de registro a serem armazenadas em buffer.

setAutoFlushBytes

STATIC   

setAutoFlushBytes(integer $bytes)

Define o tamanho máximo de registros a serem armazenados em buffer antes de serem transferidos automaticamente ao adicionar a próxima entrada de registro.

Parâmetros

Nome Descrição

$bytes

integer

Tamanho dos registros a serem armazenados em buffer em bytes.

setLogFlushTimeLimit

STATIC   

setLogFlushTimeLimit(integer $seconds)

Define a quantidade máxima de tempo em segundos antes que os registros armazenados em buffer sejam transferidos automaticamente após a adição da próxima entrada de registro.

Parâmetros

Nome Descrição

$seconds

integer

Tempo em segundos. Use um valor zero ou negativo para desativar o limite de tempo.

getAppEngineLogLevel

STATIC   

getAppEngineLogLevel(integer $syslog_level) : integer

Converte um nível de prioridade syslog de PHP em um nível de gravidade do Google App Engine. Útil ao filtrar registros por nível de gravidade mínima, dado o nível de syslog.

Parâmetros

Nome Descrição

$syslog_level

integer

O nível de prioridade transmitido para syslog.

Retorna

integer

O nível de gravidade do App Engine.