Simple Log Service:GetHistograms

Descrição da operação

• O Host na sintaxe da solicitação consiste no nome do projeto e no endpoint do Simple Log Service. Você deve especificar o projeto no Host.

• Um par de AccessKey é criado e obtido. Para mais informações, consulte Par de AccessKey.

O par de AccessKey de uma conta Alibaba Cloud tem permissões de acesso a todas as operações de API, o que representa altos riscos de segurança. Crie e use um usuário do Resource Access Management (RAM) para invocar operações de API ou executar O&M de rotina. O usuário RAM deve ter permissões para gerenciar recursos do Simple Log Service (recurso EPS), como logs de operação. Para mais informações, consulte Criar um usuário RAM e autorização.

• O nome do projeto, a região e o nome do Logstore ao qual os logs pertencem são identificados. Para mais informações, consulte Gerenciar um projeto e Gerenciar um Logstore.

• Os índices são configurados antes de você consultar os logs. Para mais informações, consulte Criar índices.

• O parâmetro de consulta suporta apenas instruções de consulta e não suporta instruções analíticas. Para mais informações sobre a sintaxe detalhada e os limites das instruções de consulta, consulte Visão geral da consulta.

• O método de divisão de subintervalo na resposta desta operação é sempre estável. Se o intervalo de tempo da solicitação de consulta permanecer inalterado, o resultado da divisão do subintervalo na resposta também permanecerá inalterado.

• Quando o número de logs envolvidos na consulta é extremamente grande, a API do Simple Log Service não pode prever quantas vezes esta operação deve ser invocada para obter os resultados completos. Portanto, verifique o valor do status de progresso no resultado retornado de cada solicitação para determinar se deve invocar repetidamente esta operação para obter os resultados completos finais. Cada invocação repetida desta operação consome o mesmo número de CUs de consulta.

• A latência desde o momento em que um log é gravado em um Logstore até o momento em que o log é consultado usando a operação GetHistograms ou GetLogs varia de acordo com o tipo de log gravado. O Simple Log Service classifica os logs nos dois tipos a seguir com base nos timestamps UNIX dos logs:

  • Dados em tempo real: O ponto no tempo no log está dentro do intervalo de (-180 segundos, 900 segundos] em relação à hora atual do servidor. Por exemplo, se a hora do log for UTC 2014-09-25 12:03:00 e o servidor receber o log às UTC 2014-09-25 12:05:00, o log será processado como dados em tempo real. A latência desde a gravação dos dados em tempo real até o momento em que eles podem ser consultados na interface LogSearch é de 3 segundos.

  • Dados históricos: O ponto no tempo no log está dentro do intervalo de [-7 × 86400 segundos, -180 segundos) em relação à hora atual do servidor. Por exemplo, se a hora do log for UTC 2014-09-25 12:00:00 e o servidor receber o log às UTC 2014-09-25 12:05:00, o log será processado como dados históricos. Isso geralmente ocorre em cenários de preenchimento retroativo de dados. A latência máxima desde a gravação dos dados em tempo real até o momento em que eles podem ser consultados é de 3 segundos. Em 99,9% dos casos, a consulta é concluída em 1 segundo.

• O Simple Log Service fornece um exemplo de uso do GetHistograms no SDK Java. Para mais informações, consulte Usar GetHistograms para consultar a distribuição de logs.