Ordnen Sie Nutzlastattribute der Kafka-Nachricht Warnungsfeldern zu

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Ordnen Sie Kafka-Nachrichtenattribute Warnungsfeldern zu, um Warnungen basierend auf den Nachrichten aussagekräftiger zu machen. Verwenden Sie die Event-Feldzuordnung, um Kafka-Schweregradwerte den entsprechenden ServiceNow -Werten zuzuordnen.

    Vorbereitungen

    Erforderliche Rolle: evt_mgmt_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Abhängig von Ihrer Nutzlast verwenden Sie Event-Feldzuordnungen, um umfassendere Informationen in einer Event-Warnung bereitzustellen, indem Sie Werte aus der Event-Feldzuordnungsregel in das Event einfügen. Transformieren Sie abhängig von Ihrer Nutzlast Informationen in Events, um bestimmte Warnungsfeldwerte auszufüllen, und erstellen Sie Warnungsfelder aus verschiedenen Werten, um Warnungen für die Nachverfolgung und Korrektur zu generieren. Verwenden Sie bei Bedarf sowohl Event-Feldzuordnungen als auch Warnungsregeln.

    In der folgenden Tabelle werden eine von einem Thema empfangene Nachricht und eine reduzierte Nutzlast im Feld Zusätzliche Informationen zum Event verglichen. Die von einem Thema empfangene Nachricht wird als einzelnes Feld reduziert und im Feld Zusätzliche Informationen zum Event angezeigt. Verwenden Sie diese vereinfachten Nachrichten, um Event-Regeln und -Zuordnungen zu erstellen.

    Tabelle : 1. Tatsächliche vs. reduzierte Nutzlast
    Tatsächliche Nutzlast, die in ein Thema eingefügt wurde Vereinfachte 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. So ordnen Sie die Kafka-Nachrichtenattribute den vordefinierten Warnungsfeldern zu, um Warnungen durch Erstellen von Event-Feldzuordnungen zu generieren.
      1. Navigieren zu Alle > Ereignismanagement > Regeln > Ereignisfeldzuordnung.
      2. Wählen Sie im Fenster „Event-Feldzuordnung“ die Option Neuaus.
      3. Geben Sie im Feld Name einen Namen für die Feldzuordnung ein.
      4. Geben Sie im Feld Quelle Kafka Consumerein.
      5. Wählen Sie im Feld Zuordnungstyp den entsprechenden Zuordnungstyp aus
      6. Eine Liste der verfügbaren Zuordnungstypen finden Sie unter Event-Feldzuordnungen.
    2. So ordnen Sie die Kafka-Nachrichtenattribute den vordefinierten Warnungsfeldern zu, um Warnungen durch Erstellen von Event-Regeln zu generieren.
      1. Navigieren zu Alle > Ereignismanagement > Regeln > Ereignisregeln.
      2. Wählen Sie Neu.
      3. Geben Sie im Feld Name einen Namen für die Event-Regel ein.
      4. Geben Sie im Feld Quelle Kafka Consumerein.
      5. Wählen Sie Event-Filter aus.
      6. Geben Sie den entsprechenden Filter entsprechend Ihrer Anforderung ein.
      7. Wählen Sie Warnungsausgabe umwandeln und verfassen aus.

        Beim Erstellen von Event-Regeln werden die Event-Felder auf der Registerkarte Event-Regeln umwandeln und Warnungsausgabe verfassen angezeigt. Da die Kafka-Nachricht von Benutzer zu Benutzer unterschiedlich ist, müssen Sie die Event-Felder in Warnungsfelder umwandeln, um die Details in der Warnung anzuzeigen.

        Hinweis:
        Da der Schweregradwert zum Erstellen einer Warnung erforderlich ist, müssen Sie das Feld Schweregrad mithilfe von Event-Regeln oder Event-Feldzuordnungen zuordnen. Wenn das Feld Schweregrad leer ist, wird das Event nicht verarbeitet und geht in einen Fehlerstatus über.
      8. Ordnen Sie die Felder des Events und das Feld Zusätzliche Informationen den Feldern der Warnung zu.
      9. Wählen Sie Bindung aus.
      10. Geben Sie die entsprechende Bindung entsprechend Ihrer Anforderung ein.
      11. Wählen Sie Absenden aus.
        Weitere Informationen finden Sie unter Event-Regel erstellen oder bearbeiten.
    3. Überprüfen Sie im Bildschirm Alle Events, ob sich eines der Events aus Kafka aufgrund einer fehlenden Event-Regel in einem Fehlerstatus befindet, und geben Sie fehlende Regeln an.
      1. Navigieren zu Alle > Ereignismanagement > Alle Ereignisse.
      2. Öffnen Sie in der Tabelle „Alle Events“ ein beliebiges Kafka-Verbraucher-Event, für das in der Spalte Schweregrad Fehler als Status angezeigt wird.

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

      3. Erstellen Sie im Bildschirm „Alle Events“ eine neue Event-Regel, indem Sie Event-Regel erstellenauswählen.
        Weitere Informationen zum Erstellen von Event-Regeln finden Sie unter Event-Regeln.

        Wenn keine Event-Feldzuordnungen für die Verarbeitung des neuen Event-Typs vorhanden sind, erstellen Sie Event-Feldzuordnungen. Weitere Informationen finden Sie unter Event-Feldzuordnungen erstellen.

    Ergebnisse

    Ihr Apache Kafka-Verbraucher-Connector ist konfiguriert. Wenn neue Nachrichten beim Kafka-Thema eingehen, werden sie in der Instanz ServiceNow als Events, empfangen, und aus diesen Events werden dann Warnungen erstellt.