DescribeSiteMonitorData - : Central de Documentação do Alibaba Cloud

Consulta os dados de monitoramento detalhados de uma tarefa de monitoramento de site.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeSiteMonitorData	A operação a ser executada. Defina o valor como DescribeSiteMonitorData.
MetricName	String	Sim	Availability	O nome da métrica. Valores válidos: Availability ResponseTime
TaskId	String	Sim	49f7b317-7645-4cc9-94fd-ea42e522****	O ID da tarefa de monitoramento de site.
Type	String	Não	metric	O tipo do objeto monitorado cujos dados de monitoramento serão consultados. Valores válidos: metric event
StartTime	String	Não	1551579637000	O início do intervalo de tempo da consulta. Formatos compatíveis: Timestamp UNIX: o valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época de 1º de janeiro de 1970, 00:00:00 UTC. Formato de hora: o valor segue o formato YYYY-MM-DDThh:mm:ssZ.
EndTime	String	Não	1551581437000	O fim do intervalo de tempo da consulta. Formatos compatíveis: Timestamp UNIX: o valor é um timestamp UNIX que representa o número de milissegundos decorridos desde a época de 1º de janeiro de 1970, 00:00:00 UTC. Formato de hora: o valor segue o formato YYYY-MM-DDThh:mm:ssZ.
Period	String	Não	60	O intervalo em que os dados de monitoramento são retornados. O valor deve ser um múltiplo inteiro de 60. Unidade: segundos. Nota O valor padrão equivale ao intervalo mínimo em que as solicitações de detecção são enviadas ao endereço monitorado.
NextToken	String	Não	49f7b317-7645-4cc9-94fd-ea42e5220930ea42e5220930ea42e522****	O cursor de paginação.
Length	Integer	Não	1000	O número de pontos de dados a serem retornados.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	3febb181-0d98-4af9-8b04-7faf36b048b9	O ID da requisição.
Code	String	200	O código de status HTTP. Nota O código de status 200 indica que a chamada foi bem-sucedida.
Success	String	true	Indica se a chamada foi bem-sucedida. O valor true indica sucesso. O valor false indica falha.
NextToken	String	ea42e5220930ea42e522****	O cursor de paginação.
Data	String	[{"Maximum":247,"Mimimum":61,"Average":154,"userId":"127067667954**","taskId":"49f7b317-7645-4cc9-94fd-ea42e522**","timestamp":1551581760000}]	Os dados de monitoramento retornados.
Message	String	Successful	A mensagem retornada.

Os dados retornados contêm uma string JSON que pode incluir alguns ou todos os seguintes parâmetros:

Error4XXRate: o percentual de resultados de detecção com códigos de status 4XX.
Error6XXRate: o percentual de resultados de detecção com códigos de status 6XX.
Error5XXRate: o percentual de resultados de detecção com códigos de status 5XX.
Error4XXNumber: o número de resultados de detecção com códigos de status 4XX.
Error5XXNumber: o número de resultados de detecção com códigos de status 5XX.
Error6XXNumber: o número de resultados de detecção com códigos de status 6XX.
Over5totalTime: o percentual de solicitações de detecção cujo tempo de resposta supera 5.000 ms.
Over3totalTime: o percentual de solicitações de detecção cujo tempo de resposta supera 3.000 ms.
Over2totalTime: o percentual de solicitações de detecção cujo tempo de resposta supera 2.000 ms.
Over10FailureRate: o percentual de pontos de detecção cuja taxa de falha das solicitações de detecção supera 10%.
Over100FailureRate: o percentual de pontos de detecção cuja taxa de falha das solicitações de detecção supera 99%.
Over30FailureRate: o percentual de pontos de detecção cuja taxa de falha das solicitações de detecção supera 30%.
Over50FailureRate: o percentual de pontos de detecção cuja taxa de falha das solicitações de detecção supera 50%.
Over80FailureRate: o percentual de pontos de detecção cuja taxa de falha das solicitações de detecção supera 80%.
Over90FailureRate: o percentual de pontos de detecção cuja taxa de falha das solicitações de detecção supera 90%.
Over400NumberRate: o percentual de resultados de detecção com códigos de status maiores que 400.
Over400NumberRate: o percentual de resultados de detecção com códigos de status maiores que 500.
AvailableNumber: o número de resultados de detecção em que o código de status é menor que 400.
UnavailableNumber: o número de resultados de detecção em que o código de status é maior que 399.
Availability: o percentual de resultados de detecção em que o código de status é menor que 400.
Unavailability: o percentual de resultados de detecção em que o código de status é maior que 399.
ErrorCodeMaximum: o código de erro máximo nos resultados de detecção retornados em um período específico. Suponha que cinco códigos de status sejam retornados em um minuto após o envio de solicitações de detecção de cinco pontos de detecção. O código de status em quatro resultados de detecção é 200 e em um resultado é 404. Nesse caso, o código de erro máximo é 404.
ErrorCodeMinimum: o código de erro mínimo nos resultados de detecção retornados em um período de monitoramento. Suponha que cinco códigos de status sejam retornados em um minuto após o envio de solicitações de detecção de cinco pontos de detecção. O código de status em quatro resultados de detecção é 200 e em um resultado é 404. Nesse caso, o código de erro mínimo é 200.

Nota

Recomendamos usar as métricas AvailableNumber, UnavailableNumber, Availability, Unavailability, ErrorCodeMaximum ou ErrorCodeMinimum, cujos valores são mais simples de calcular.

Exemplos

Exemplos de requisição

http(s)://[Endpoint]/? Action=DescribeSiteMonitorData
&MetricName=Availability
&TaskId=49f7b317-7645-4cc9-94fd-ea42e522****
&<Common request parameters>

Exemplos de respostas bem-sucedidas

XML format

<DescribeSiteMonitorData>
		  <Data>
			    <Over5totalTime>0</Over5totalTime>
			    <Error4XXRate>0</Error4XXRate>
			    <UnavailableNumber>0</UnavailableNumber>
			    <Over2totalTime>0</Over2totalTime>
			    <timestamp>1551581040000</timestamp>
			    <Over100FailureRate>0</Over100FailureRate>
			    <Over10FailureRate>0</Over10FailureRate>
			    <Availability>100</Availability>
			    <Over80FailureRate>0</Over80FailureRate>
			    <userId>123****</userId>
			    <AvailableNumber>2</AvailableNumber>
			    <Unavailability>0</Unavailability>
			    <ErrorCodeMaximum>0</ErrorCodeMaximum>
			    <Over10totalTime>0</Over10totalTime>
			    <taskId>49f7b317-7645-4cc9-94fd-1****</taskId>
			    <Over30FailureRate>0</Over30FailureRate>
			    <Error6XXRate>0</Error6XXRate>
			    <Over500NumberRate>0</Over500NumberRate>
			    <Over3totalTime>0</Over3totalTime>
			    <Over400NumberRate>0</Over400NumberRate>
			    <Error5XXRate>0</Error5XXRate>
			    <Error5XXNumber>0</Error5XXNumber>
			    <Over90FailureRate>0</Over90FailureRate>
			    <Error4XXNumber>0</Error4XXNumber>
			    <Over50FailureRate>0</Over50FailureRate>
			    <ErrorCodeMinimum>0</ErrorCodeMinimum>
			    <Error6XXNumber>0</Error6XXNumber>
		  </Data>
		  <Data>
			    <Over5totalTime>0</Over5totalTime>
			    <Error4XXRate>0</Error4XXRate>
			    <UnavailableNumber>0</UnavailableNumber>
			    <Over2totalTime>0</Over2totalTime>
			    <timestamp>1551581100000</timestamp>
			    <Over100FailureRate>0</Over100FailureRate>
			    <Over10FailureRate>0</Over10FailureRate>
			    <Availability>100</Availability>
			    <Over80FailureRate>0</Over80FailureRate>
			    <userId>12345</userId>
			    <AvailableNumber>2</AvailableNumber>
			    <Unavailability>0</Unavailability>
			    <ErrorCodeMaximum>0</ErrorCodeMaximum>
			    <Over10totalTime>0</Over10totalTime>
			    <taskId>49f7b317-7645-4cc9-94fd-1****</taskId>
			    <Over30FailureRate>0</Over30FailureRate>
			    <Error6XXRate>0</Error6XXRate>
			    <Over500NumberRate>0</Over500NumberRate>
			    <Over3totalTime>0</Over3totalTime>
			    <Over400NumberRate>0</Over400NumberRate>
			    <Error5XXRate>0</Error5XXRate>
			    <Error5XXNumber>0</Error5XXNumber>
			    <Over90FailureRate>0</Over90FailureRate>
			    <Error4XXNumber>0</Error4XXNumber>
			    <Over50FailureRate>0</Over50FailureRate>
			    <ErrorCodeMinimum>0</ErrorCodeMinimum>
			    <Error6XXNumber>0</Error6XXNumber>
		  </Data>
		  <RequestId>DBDEAC51-EA3C-4853-8F25-6B48D38A28A9</RequestId>
		  <Success>true</Success>
		  <Code>200</Code>
</DescribeSiteMonitorData>

JSON format

{
    "Data": [
        {
            "Over5totalTime": 0,
            "Error4XXRate": 0,
            "UnavailableNumber": 0,
            "Over2totalTime": 0,
            "timestamp": 1551581040000,
            "Over100FailureRate": 0,
            "Over10FailureRate": 0,
            "Availability": 100,
            "Over80FailureRate": 0,
            "userId": "123****",
            "AvailableNumber": 2,
            "Unavailability": 0,
            "ErrorCodeMaximum": 0,
            "Over10totalTime": 0,
            "taskId": "49f7b317-7645-4cc9-94fd-1****",
            "Over30FailureRate": 0,
            "Error6XXRate": 0,
            "Over500NumberRate": 0,
            "Over3totalTime": 0,
            "Over400NumberRate": 0,
            "Error5XXRate": 0,
            "Error5XXNumber": 0,
            "Over90FailureRate": 0,
            "Error4XXNumber": 0,
            "Over50FailureRate": 0,
            "ErrorCodeMinimum": 0,
            "Error6XXNumber": 0
        },
        {
            "Over5totalTime": 0,
            "Error4XXRate": 0,
            "UnavailableNumber": 0,
            "Over2totalTime": 0,
            "timestamp": 1551581100000,
            "Over100FailureRate": 0,
            "Over10FailureRate": 0,
            "Availability": 100,
            "Over80FailureRate": 0,
            "userId": "12345",
            "AvailableNumber": 2,
            "Unavailability": 0,
            "ErrorCodeMaximum": 0,
            "Over10totalTime": 0,
            "taskId": "49f7b317-7645-4cc9-94fd-1****",
            "Over30FailureRate": 0,
            "Error6XXRate": 0,
            "Over500NumberRate": 0,
            "Over3totalTime": 0,
            "Over400NumberRate": 0,
            "Error5XXRate": 0,
            "Error5XXNumber": 0,
            "Over90FailureRate": 0,
            "Error4XXNumber": 0,
            "Over50FailureRate": 0,
            "ErrorCodeMinimum": 0,
            "Error6XXNumber": 0
        }
    ],
    "RequestId": "DBDEAC51-EA3C-4853-8F25-6B48D38A28A9",
    "Success": true,
    "Code": "200"
}

Códigos de erro

Para consultar a lista de códigos de erro, acesse o API Error Center.