Nutzlastattribute der Kafka-Nachricht an Warnungsfelder zuordnen

Ordnen Sie Kafka-Nachrichtenattribute Warnungsfeldern zu, um Warnungen basierend auf den Nachrichten aussagekräftiger zu machen. Verwenden Sie die Ereignisfeldzuordnung, um Kafka-Schweregradwerte entsprechend zuzuordnen ServiceNow Werte.

Vorbereitungen

Erforderliche Rolle: evt_mgmt_admin

Warum und wann dieser Vorgang ausgeführt wird

Je nach Nutzlast können Sie Ereignisfeldzuordnungen verwenden, um umfassendere Informationen in einer Ereigniswarnung bereitzustellen, indem Sie Werte aus der Ereignisfeldzuordnungsregel in das Ereignis ersetzen. Wandeln Sie je nach Nutzlast Informationen in Ereignissen um, um die angegebenen Warnungsfeldwerte auszufüllen, und verfassen Sie Warnungsfelder aus verschiedenen Werten, um Warnungen zur Nachverfolgung und Korrektur zu generieren. Verwenden Sie bei Bedarf sowohl Ereignisfeldzuordnungen als auch Warnungsregeln.

Die folgende Tabelle vergleicht eine von einem Thema empfangene Nachricht mit einer reduzierten Nutzlast im Ereignis Zusätzliche Informationen Feld. Die von einem Thema empfangene Nachricht wird als einzelnes Feld reduziert und im Ereignis angezeigt Zusätzliche Informationen Feld. Verwenden Sie diese reduzierten Nachrichten, um Ereignisregeln und -Zuordnungen zu erstellen.

Tabelle : 1. Tatsächliche vs. Reduzierte Nutzlast

Tatsächliche Nutzlast, die in ein Thema eingefügt wurde

Reduzierte Nutzlast im Feld „zusätzliche Informationen“

{ "version": "v0.1.0", "name": "fibsrc", "id": "mnop6789", "trigger_description": "Triggers on duration_ms goes above 5K", "status": "TRIGGERED", "alert_type": "on_true", "summary": "Triggered: fibsrc", "description": "Current value (12.296815 k) greater than threshold value (5 k)", "operator": "greater than", "threshold": 5000, "groups": [ { "Group": "GroupA", "Result": 12296.815478000368 } ], "trigger": { "Result": 12296.815478000368 } }

{ "flattened.alert_type": "on_true", "flattened.description": "Current value (12.296815 k) greater than threshold value (5 k)", "flattened.id": " mnop6789", "flattened.kafkaKey": "null", "flattened.kafkaOffset": "28", "flattened.kafkaPartition": "0", "flattened.kafkaTopicName": "topic123", "flattened.name": "fibsrc", "flattened.operator": "greater than", "flattened.status": "TRIGGERED", "flattened.summary": "Triggered: fibsrc", "flattened.trigger_description": "Triggers on duration_ms goesa above 5K", "flattened.version": "v0.1.0", "flattened.version": 5000, "flattened.groups.0.Group": "GroupA", "flattened.groups.0.Result": 12296.815478000368, "flattened.trigger.Result": 12296.815478000368 }

Prozedur

1. Um die Kafka-Nachrichtenattribute den vordefinierten Warnungsfeldern zuzuordnen, um Warnungen durch Erstellen von Ereignisfeldzuordnungen zu generieren.
   1. Navigieren zu Alle > Ereignismanagement > Bedingungen > Ereignisfeldzuordnungan.
   2. Wählen Sie im Fenster Ereignisfeldzuordnung die Option aus Neu .
   3. Geben Sie im Feld Name einen Namen für die Feldzuordnung ein.
   4. Geben Sie im Feld Quelle den Wert ein Kafka-Verbraucher .
   5. Wählen Sie im Feld Zuordnungstyp den entsprechenden Zuordnungstyp aus
   6. Eine Liste der verfügbaren Zuordnungstypen finden Sie unter Ereignisfeldzuordnungen .
2. Um die Kafka-Nachrichtenattribute den vordefinierten Warnungsfeldern zuzuordnen, um Warnungen durch Erstellen von Ereignisregeln zu generieren.
   1. Navigieren zu Alle > Ereignismanagement > Bedingungen > Ereignisregelnan.
   2. Wählen Sie Aus Neu .
   3. Geben Sie im Feld Name einen Namen für die Ereignisregel ein.
   4. Geben Sie im Feld Quelle den Wert ein Kafka-Verbraucher .
   5. Wählen Sie Aus Ereignisfilter .
   6. Geben Sie den entsprechenden Filter entsprechend Ihrer Anforderung ein.
   7. Wählen Sie Aus Transformieren und verfassen Sie die Warnungsausgabe .

      Beim Erstellen von Ereignisregeln werden die Ereignisfelder auf den Registerkarten Ereignisregeln transformieren und Warnungsausgabe verfassen angezeigt. Da die Kafka-Nachricht von Anwender zu Anwender variiert, müssen Sie die Ereignisfelder in Warnungsfelder umwandeln, um die Details in der Warnung anzuzeigen.

      Hinweis:

      Da der Schweregradwert zum Erstellen einer Warnung erforderlich ist, müssen Sie zuordnen Schweregrad Feld mit Ereignisregeln oder Ereignisfeldzuordnungen. Wenn das Feld Schweregrad leer ist, wird das Ereignis nicht verarbeitet und in einen Fehlerstatus versetzt.
   8. Ordnen Sie die Felder des Ereignisses und zu Zusätzliche Informationen Feld zu den Feldern der Warnung.
   9. Wählen Sie Aus Bindung .
   10. Geben Sie die entsprechende Bindung entsprechend Ihren Anforderungen ein.
   11. Wählen Sie Absenden.
       Weitere Informationen finden Sie unter Event-Regel erstellen oder bearbeiten.
3. Überprüfen Sie im Bildschirm „alle Ereignisse“, ob sich eines der Ereignisse aus Kafka aufgrund einer fehlenden Ereignisregel in einem Fehlerstatus befindet, und geben Sie fehlende Regeln an.
   1. Navigieren zu Alle > Ereignismanagement > Alle Ereignissean.
   2. Öffnen Sie in der Tabelle alle Ereignisse ein Kafka-Verbraucherereignis, das Fehler als Status in anzeigt Schweregrad Spalte.

      Die vom Kafka-Verbraucher empfangene Nachricht kann variieren. Da der Connector die empfangenen Attribute nicht kennen kann, müssen Sie zuordnen Schweregrad Feld oder andere Ereignisfelder zu den Feldern in der Nachricht, um sicherzustellen, dass Warnungsfelder korrekt ausgefüllt sind.

   3. Erstellen Sie auf dem Bildschirm alle Ereignisse eine neue Ereignisregel, indem Sie auswählen Erstellen Sie Eine Ereignisregel .
      Weitere Informationen zum Erstellen von Ereignisregeln finden Sie unter Ereignisregeln.

      Wenn keine Ereignisfeldzuordnungen vorhanden sind, um den neuen Ereignistyp zu verarbeiten, erstellen Sie Ereignisfeldzuordnungen. Weitere Informationen finden Sie unter Event-Feldzuordnungen erstellen.

Ergebnisse

Ihr Apache Kafka-Verbraucher-Connector ist konfiguriert. Wenn neue Nachrichten im Kafka-Thema eintreffen, werden sie in empfangen ServiceNow Instanz als Ereignisse , Und -Warnungen werden dann aus diesen Ereignissen erstellt.