Udostępnij przez

Przestrzeń nazw usługi Azure Event Grid jako źródło usługi Event Grid

Ten artykuł przedstawia właściwości i schematy zdarzeń w przestrzeni nazw usługi Azure Event Grid. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid.

Dostępne typy zdarzeń

Przestrzeń nazw usługi Azure Event Grid emituje następujące typy zdarzeń:

Typ zdarzenia Description
Microsoft.EventGrid.MQTTClientSessionConnected Opublikowano, gdy sesja klienta MQTT jest połączona z usługą Event Grid.
Microsoft.EventGrid.MQTTClientSessionDisconnected Opublikowane, gdy sesja klienta MQTT jest odłączona od usługi Event Grid.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated Opublikowanie następuje po utworzeniu lub zaktualizowaniu klienta MQTT w przestrzeni nazw usługi Event Grid.
Microsoft.EventGrid.MQTTClientDeleted Opublikowane po usunięciu klienta MQTT z przestrzeni nazw usługi Event Grid.

Przykładowe zdarzenie

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego, gdy sesja klienta MQTT jest połączona z usługą Event Grid:

[{
  "specversion": "1.0",
  "id": "5249c38a-a048-46dd-8f60-df34fcdab06c",
  "time": "2023-07-29T01:23:49.6454046Z",
  "type": "Microsoft.EventGrid.MQTTClientSessionConnected",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1
  }
}]

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego, gdy sesja klienta MQTT jest rozłączona z usługą Event Grid:

[{
  "specversion": "1.0",
  "id": "e30e5174-787d-4e19-8812-580148bfcf7b",
  "time": "2023-07-29T01:27:40.2446871Z",
  "type": "Microsoft.EventGrid.MQTTClientSessionDisconnected",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1,
    "disconnectionReason": "ClientInitiatedDisconnect"
  }
}]

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego podczas tworzenia lub aktualizowania klienta MQTT w przestrzeni nazw usługi Event Grid:

[{
  "specversion": "1.0",
  "id": "383d1562-c95f-4095-936c-688e72c6b2bb",
  "time": "2023-07-29T01:14:35.8928724Z",
  "type": "Microsoft.EventGrid.MQTTClientCreatedOrUpdated",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "data": {
    "createdOn": "2023-07-29T01:14:34.2048108Z",
    "updatedOn": "2023-07-29T01:14:34.2048108Z",
    "namespaceName": "myns",
    "clientName": "client1",
    "clientAuthenticationName": "client1",
    "state": "Enabled",
    "attributes": {
      "attribute1": "value1"
    }
  }
}]

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego po usunięciu klienta MQTT z przestrzeni nazw usługi Event Grid:

[{
  "specversion": "1.0",
  "id": "2a93aaf9-66c2-4f8e-9ba3-8d899c10bf17",
  "time": "2023-07-29T01:30:52.5620566Z",
  "type": "Microsoft.EventGrid.MQTTClientDeleted",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "data": {
    "namespaceName": "myns",
    "clientName": "client1",
    "clientAuthenticationName": "client1"
  }
}]

Właściwości zdarzenia

Wszystkie zdarzenia zawierają te same dane najwyższego poziomu:

Majątek Typ Description
id ciąg Unikalny identyfikator zdarzenia.
source ciąg Pełna ścieżka zasobu prowadząca do źródła zdarzenia. To pole nie jest możliwe do zapisu. Usługa Event Grid udostępnia tę wartość.
subject ciąg Ścieżka do tematu wydarzenia zdefiniowana przez wydawcę.
type ciąg Jeden z zarejestrowanych typów zdarzeń dla tego źródła zdarzeń.
time ciąg Czas generowania zdarzenia na podstawie czasu UTC dostawcy.
data obiekt Dane zdarzeń przestrzeni nazw Event Grid.
specversion ciąg Wersja specyfikacji schematu CloudEvents.

Obiekt danych zawiera następujące właściwości:

Majątek Typ Description
namespaceName ciąg Nazwa przestrzeni nazw usługi Event Grid, w której klient MQTT był połączony lub odłączony.
clientAuthenticationName ciąg Unikatowy identyfikator klienta MQTT, który klient przedstawia usłudze na potrzeby uwierzytelniania. Ten ciąg z uwzględnieniem wielkości liter może zawierać maksymalnie 128 znaków i obsługuje znaki UTF-8.
clientSessionName ciąg Unikatowy identyfikator sesji klienta MQTT. Ten ciąg znaków uwzględniający wielkość liter może zawierać maksymalnie 128 znaków i obsługuje znaki UTF-8.
sequenceNumber long Liczba, która pomaga wskazać kolejność zdarzeń połączonych lub rozłączonych sesji klienta MQTT. Najnowsze zdarzenie będzie miało numer sekwencji, który jest wyższy niż poprzednie zdarzenie.
disconnectionReason ciąg Przyczyna rozłączenia sesji klienta MQTT. Wartość może być jedną z wartości w tabeli przyczyn rozłączenia.
createdOn ciąg Czas utworzenia zasobu klienta na podstawie czasu UTC dostawcy.
updatedOn ciąg Czas ostatniej aktualizacji zasobu klienta na podstawie czasu UTC dostawcy. Jeśli zasób klienta nigdy nie został zaktualizowany, ta wartość jest identyczna z wartością właściwości "createdOn"
clientName ciąg Czas ostatniej aktualizacji zasobu klienta na podstawie czasu UTC dostawcy. Jeśli zasób klienta nigdy nie został zaktualizowany, ta wartość jest identyczna z wartością właściwości "createdOn".
state ciąg Stan skonfigurowanego klienta. Wartość może być włączona lub wyłączona.
attributes ciąg Tablica atrybutów pary klucz-wartość, które są przypisane do zasobu klienta.

Przyczyny rozłączenia:

Poniższa lista zawiera szczegółowe informacje o różnych wartościach parametru disconnectionReason i ich opisie:

Przyczyna rozłączenia Description
Błąd ClientAuthenticationError klient został odłączony z przyczyn uwierzytelniania (na przykład certyfikat wygasł, klient został wyłączony lub zmieniono konfigurację klienta)
Błąd autoryzacji klienta klient został odłączony z jakiegokolwiek powodu związanego z autoryzacją (na przykład ze względu na zmianę konfiguracji przestrzeni tematycznych, powiązań uprawnień lub grup klientów)
Błąd klienta klient wysłał nieprawidłowe żądanie lub użył jednej z nieobsługiwanych funkcji, które spowodowały zakończenie połączenia przez usługę.
ClientInitiatedDisconnect klient inicjuje bezproblemowe rozłączenie za pośrednictwem pakietu DISCONNECT dla MQTT lub ramki zamknięcia protokołu MQTT za pośrednictwem protokołu WebSocket.
ConnectionLost połączenie klient-serwer zostanie utracone.
Adres IP niedozwolony adres IP klienta jest blokowany przez filtr IP lub konfigurację linków prywatnych.
QuotaExceeded klient przekroczył co najmniej jeden limit ograniczania przepustowości, który spowodował zakończenie połączenia przez usługę.
Błąd serwera połączenie zostało zakończone z powodu nieoczekiwanego błędu serwera
OdłączenieZainicjowanePrzezSerwer serwer inicjuje bezproblemowe rozłączenie z dowolnego powodu operacyjnego
SesjaPrzepływ pracy kolejka klienta dla niezaznaczonych komunikatów QoS1 osiągnęła limit, co spowodowało zakończenie połączenia przez serwer
Przejęto sesję klient ponownie nawiązał połączenie z tą samą nazwą uwierzytelniania, co spowodowało zakończenie poprzedniego połączenia.

Dalsze kroki

  • Aby dowiedzieć się więcej o tematach systemu usługi Event Grid, zobacz Tematy systemowe
  • Aby dowiedzieć się więcej o zdarzeniach emitowanych przez przestrzeń nazw usługi Event Grid i sposobie ich używania, zobacz Zdarzenia cyklu życia klienta MQTT.
  • Last updated on