Compartilhar via

Obter lista de eventos de serviço

  • Artigo

Obtém eventos relacionados a um Serviço.

A resposta será uma lista de objetos ServiceEvent.

Solicitação

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

Parâmetros

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

serviceId

Tipo: string
Obrigatório: sim

A identidade do serviço. Normalmente, essa ID é o nome completo do serviço sem o esquema de 'malha' do URI. A partir da versão 6.0, nomes hierárquicos são delimitados pelo caractere "~". Por exemplo, se o nome do serviço for "fabric:/myapp/app1/svc1", a identidade do serviço será "myapp~app1~svc1" na versão 6.0 e superiores e and "myapp/app1/svc1" em versões anteriores.

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 baseia-se na versão de runtime na qual a API foi introduzida ou foi 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 nesta especificação.

Além disso, o runtime aceita qualquer versão que seja maior do 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 ServiceEvent.
 matriz de ServiceEvent
Todos os outros códigos de status A resposta de erro detalhada.
 FabricError

Exemplos

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

Solicitação

GET http://localhost:19080/EventsStore/Services/app1~svc1/$/Events?api-version=6.4&StartTimeUtc=2018-04-03T18:00:00Z&EndTimeUtc=2018-04-04T18:00:00Z

Resposta 200

Corpo
[
  {
    "Kind": "ServiceCreated",
    "ServiceTypeName": "Svc1Type",
    "ApplicationName": "fabric:/app1",
    "ApplicationTypeName": "App1Type",
    "ServiceInstance": "131672605579916060",
    "IsStateful": true,
    "PartitionCount": "2",
    "TargetReplicaSetSize": "3",
    "MinReplicaSetSize": "2",
    "ServicePackageVersion": "1.0:1.0",
    "PartitionId": "bd936249-183d-4e29-94ab-2e198e4e2e87",
    "ServiceId": "app1/svc1",
    "EventInstanceId": "8ba26506-4a93-4b8c-ae14-29a2841b3003",
    "TimeStamp": "2018-04-03T20:22:38.0560496Z",
    "HasCorrelatedEvents": false
  }
]