Share via

Obter lista de eventos do cluster

  • Artigo

Obtém todos os eventos relacionados aos Clusters.

A resposta será uma lista de objetos ClusterEvent.

Solicitação

Método URI da solicitação
GET /EventsStore/Cluster/Events?api-version=6.4&timeout={timeout}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&EventsTypesFilter={EventsTypesFilter}&ExcludeAnalysisEvents={ExcludeAnalysisEvents}&SkipCorrelationLookup={SkipCorrelationLookup}

Parâmetros

Nome Type Obrigatório Location
api-version string Sim Consulta
timeout inteiro (int64) No Consulta
StartTimeUtc string Sim Consulta
EndTimeUtc string Sim Consulta
EventsTypesFilter string Não Consulta
ExcludeAnalysisEvents booleano No Consulta
SkipCorrelationLookup booleano No Consulta

api-version

Tipo: string
Obrigatório: sim
Padrão: 6.4

A versão da API. Esse parâmetro é necessário e seu valor deve ser '6.4'.

A versão da API REST do Service Fabric é baseada na versão de runtime na qual a API foi introduzida ou alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta versão é a versão mais recente com suporte da API. Se uma versão inferior da API for passada, a resposta retornada poderá ser diferente daquela documentada nessa especificação.

Além disso, o runtime aceita qualquer versão maior que a versão mais recente com suporte até a versão atual do runtime. Portanto, se a versão mais recente da API for 6.0 e o runtime for 6.1, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão documentada 6.0.

timeout

Tipo: inteiro (int64)
Obrigatório: não
Padrão: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos.

StartTimeUtc

Tipo: string
Obrigatório: sim

A hora de início de uma consulta de pesquisa no ISO UTC aaaa-MM-ddTHH:mm:ssZ.

EndTimeUtc

Tipo: string
Obrigatório: sim

A hora de término de uma consulta de pesquisa no ISO UTC aaaa-MM-ddTHH:mm:ssZ.

EventsTypesFilter

Tipo: string
Obrigatório: não

Esta é uma cadeia de caracteres separada por vírgula que especifica os tipos de FabricEvents que deverão ser incluídos somente na resposta.

ExcludeAnalysisEvents

Tipo: booliano
Obrigatório: não

Este parâmetro desabilita a recuperação de AnalysisEvents caso true seja aprovado.

SkipCorrelationLookup

Tipo: booliano
Obrigatório: não

Este parâmetro desabilita a pesquisa de informações de CorrelatedEvents caso true seja aprovado. Caso contrário, o CorrelationEvents será processado e o campo HasCorrelatedEvents será preenchido em cada FabricEvent.

Respostas

Código de status HTTP Descrição Esquema de Resposta
200 (OK) Lista de objetos de eventos com o tipo base ClusterEvent.
 matriz de ClusterEvent
Todos os outros códigos status A resposta de erro detalhada.
 FabricError

Exemplos

Este exemplo mostra como obter todos os eventos relacionados ao cluster durante uma determinada janela de tempo.

Solicitação

GET http://localhost:19080/EventsStore/Cluster/Events?api-version=6.4&StartTimeUtc=2018-04-03T18:00:00Z&EndTimeUtc=2018-04-04T18:00:00Z

Resposta 200

Corpo
[
  {
    "Kind": "ClusterUpgradeStarted",
    "CurrentClusterVersion": "0.0.0.0:",
    "TargetClusterVersion": "6.2:1.0",
    "UpgradeType": "Rolling",
    "RollingUpgradeMode": "UnmonitoredAuto",
    "FailureAction": "Manual",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:18:59.4313064Z",
    "HasCorrelatedEvents": false
  },
  {
    "Kind": "ClusterUpgradeDomainCompleted",
    "TargetClusterVersion": "6.2:1.0",
    "UpgradeState": "RollingForward",
    "UpgradeDomains": "(0 1 2)",
    "UpgradeDomainElapsedTimeInMs": "78.5288",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:19:59.5729953Z",
    "HasCorrelatedEvents": false
  },
  {
    "Kind": "ClusterUpgradeDomainCompleted",
    "TargetClusterVersion": "6.2:1.0",
    "UpgradeState": "RollingForward",
    "UpgradeDomains": "(3 4)",
    "UpgradeDomainElapsedTimeInMs": "0",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:20:59.6271949Z",
    "HasCorrelatedEvents": false
  },
  {
    "Kind": "ClusterUpgradeCompleted",
    "TargetClusterVersion": "6.2:1.0",
    "OverallUpgradeElapsedTimeInMs": "120196.5212",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:20:59.8134457Z",
    "HasCorrelatedEvents": false
  }
]