Eine CI-Identifizierungsregel erstellen oder bearbeiten

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 9 Minuten Lesedauer
  • Identifizierungsregeln dienen der eindeutigen Identifizierung der CIs in der CMDB im Rahmen des Identifikations- und Abgleichsverfahrens. Jede CMDB-Klasse kann einer einzelnen Identifizierungsregel zugeordnet werden.

    Vorbereitungen

    Erforderliche Rolle: itil mit Lesezugriff, itil_admin (zusätzlich zu itil) mit vollem Zugriff.

    Warum und wann dieser Vorgang ausgeführt wird

    Geben Sie in einer CI-Identifizierungsregel einen CI Bezeichner sowie Bezeichner-Einträge und zugehörige Einträge an, die das CI eindeutig identifizieren.

    Überprüfen Sie Folgendes, bevor Sie Identifizierungsregeln erstellen:

    Prozedur

    1. Navigieren zu Alle > Konfiguration > CI-Klassen Manager.
    2. Klicken Sie auf Hierarchie, um die Liste der CI-Klassen anzuzeigen.
    3. Wählen Sie die Klasse aus, für die eine Identifizierungsregel erstellt werden soll.
    4. Erweitern Sie in der Klassennavigationsleiste Klasseninformationen, und klicken Sie dann auf Identifizierungsregel.
    5. Klicken Sie auf Bearbeiten, um eine vorhandene Regel zu bearbeiten, oder klicken Sieim Abschnitt „Identifizierungsregel“ auf Hinzufügen, um eine Regel zu erstellen.
      Füllen Sie das Formular aus, und klicken Sie dann auf Speichern.
      Feld Beschreibung
      Unabhängig/Abhängig Angabe, ob der CI Identifier das CI unabhängig von anderen CIs identifizieren kann oder nicht.
      Hinweis:
      Um die Regel als Abhängig zu definieren, müssen Sie abhängige Beziehungsregeln für die ausgewählte Klasse angeben.
      Name Name des CI Bezeichners.
      Beschreibung Beschreibung des CI-Bezeichners.
    6. Klicken Sie im Abschnitt Bezeichnereinträge auf einen vorhandenen Bezeichnereintrag, um ihn zu bearbeiten, oder klicken Sie auf Hinzufügen, um einen zu erstellen.
    7. Wählen Sie im Dialogfeld „Bezeichnereintrag“ eine Option aus, und klicken Sie dann auf Weiter.
      Fahren Sie mit einem der folgenden drei Schritte gemäß der von Ihnen ausgewählten Option fort.
      Option Beschreibung
      Verwenden Sie Attribute aus der Haupttabelle <table> Ermöglicht Ihnen die Auswahl von Attributen aus der derzeit ausgewählten Tabelle (regulärer Bezeichner-Eintrag).
      Attribute aus einer anderen Tabelle (Suchtabelle) verwenden Ermöglicht Ihnen die Auswahl von Attributen aus einer beliebigen zugehörigen Tabelle mit Ausnahme der derzeit ausgewählten Tabelle (Such-Bezeichner-Eintrag).
      Attribute aus der Haupttabelle und einer weiteren Tabelle (Hybrid) verwenden Ermöglicht Ihnen die Auswahl von Attributen aus der derzeit ausgewählten Tabelle und aus anderen Tabellen (hybrider Bezeichner-Eintrag).
    8. Attribute aus Haupttabelle <'table'> verwenden : Legen Sie die Optionen im Formular fest, und klicken Sie dann auf Speichern.

      „Tabelle durchsuchen“ ist auf die aktuell ausgewählte Tabelle in der CI-Klassenliste voreingestellt.

      Feld Beschreibung
      Aktiv Kontrollkästchen, das angibt, dass der Bezeichner-Eintrag aktiv ist. Eine Identifizierungsregel muss mindestens einen aktiven Bezeichner-Eintrag aufweisen.
      Priorität Priorität des Bezeichner-Eintrags. Bezeichner-Einträge werden auf Grundlage von Prioritäten angewendet. Regeln mit niedrigeren Prioritätszahlen werden mit höherer Priorität behandelt. Bezeichner-Einträge von identischer Priorität werden nach dem Zufallsprinzip angewendet.

      Sie können zwischen den Prioritätszahlen Lücken lassen, um die Zuweisung ungenutzter Zahlen zu neuen Einträgen zu ermöglichen, ohne die bestehende Prioritätsreihenfolge verändern zu müssen.

      Kriteriumsattribute Satz von Attributen, die das CI eindeutig identifizieren. Attribute gehören entweder zu der aktuellen Klasse oder einer übergeordneten Klasse.
      Hinweis:
      Das Hinzufügen von Referenzfeldern als Kriteriumsattribute ist möglich. Solche Felder sind jedoch möglicherweise nicht immer wirksam:
      • In Referenzfeldern werden sys_ids gespeichert, die auf einen Datensatz in einer anderen Tabelle verweisen. Somit gelten Referenzfelder (bezüglich der Eindeutigkeit) als schwache Kriteriumsattribute für die aktuelle Tabelle.
      • Vom System werden ungültige Werte in einem Referenzfeld erkannt und dann durch „Unbekannt“ ersetzt. Beispielsweise wird ein ungültiger Wert für Model ID durch den Wert „Unbekannt“ ersetzt. Wenn für mehrere CIs dasselbe Referenzfeld auf „Unbekannt“ festgelegt ist, werden diese CIs auch zu doppelten CIs.
      Null-Attribut unterstützen

      Wenn diese Option ausgewählt ist und mindestens ein Kriteriumsattribut nicht NULL ist, wird versucht, einen Abgleich mit einem Bezeichnereintrag durchzuführen, auch wenn Kriteriumsattribute NULL sind.

      Andernfalls müssen alle Kriteriumsattribute Werte aufweisen, damit versucht werden kann, eine Übereinstimmung mit einem Bezeichner-Eintrag zu erzielen.

      Rückgriff auf übergeordnete Regeln zulassen Ermöglicht die Verwendung der Identifizierungsregeln des übergeordneten Elements des CIs, wenn für diese Identifizierungsregel keine Übereinstimmung gefunden wird. Gilt nur für abhängige Identifizierungsregeln.

      Erweiterte Optionen

      Ein Filter zum Eingrenzen des Datensatzes, in dem ein übereinstimmendes CI gesucht wird.

      Nur verfügbar, wenn die Systemeigenschaft glide.identification_engine.enable_identifier_optional_condition auf „ true “ festgelegt ist (standardmäßig „false “). Im Basissystem sind Bezeichnereinträge verschiedener Klassen mit erweiterten Optionenbedingungen vorkonfiguriert. Alle diese vorkonfigurierten Bedingungen in regulären Bezeichnereinträgen werden automatisch angewendet, wenn Sie diese Eigenschaft auf truesetzen. Um unerwartetes Verhalten zu verhindern, überprüfen Sie daher diese vordefinierten Bedingungen in regulären Bezeichnereinträgen, bevor Sie diese Eigenschaft auf truesetzen.

      Weitere Informationen zu dieser Eigenschaft finden Sie unter Eigenschaften für Identifizierung und Abgleich.

      Hinweis:
      Wenn Kriteriumsattribute nur zwei Attribute haben und sys_class_name eines davon ist (z. B. [name, sys_class_name], [ip_address, sys_class_name]), kann das andere Attribut nicht NULL sein, auch wenn das Attribut Null zulassen aktiviert ist. Diese Einschränkung ist darauf zurückzuführen, dass sys_class_name als ein spezielles, übereinstimmendes System-Attribut betrachtet wird.
    9. Option „Attribute aus einer anderen Tabelle verwenden“ (Suchtabelle) :
      1. Legen Sie Tabelle durchsuchen auf eine andere Tabelle als die aktuell in der CI-Klassenliste ausgewählte Tabelle fest.
        Die Tabelle „Suche in“ muss ein Referenzfeld zu cmdb_cihaben, andernfalls wird der Identifier-Eintrag als ungültig betrachtet.
      2. Legen Sie die restlichen Felder fest, wie im vorherigen Schritt beschrieben.
      3. Wahlweise: Klicken Sie auf Erweiterte Optionen, und geben Sie die Informationen für einen Suchbezeichner ein (scrollen Sie bei Bedarf nach unten).
        Erweiterte Option Beschreibung
        Diese Bedingungen müssen alle erfüllt werden. Ein Filter zum Eingrenzen des Datensatzes, in dem ein übereinstimmendes CI gesucht wird.
        Exakte Übereinstimmung mit Anzahl erzwingen Ordnen Sie für die Suchidentifizierung ein CI nur bei exakter Übereinstimmung mit der Anzahl der Suchdatensätze zu.
        Wenn dies erzwungen wird, müssen alle Suchelemente für ein CI in der Nutzlast übereinstimmende Datensätze in der Suchtabelle haben, die auf dasselbe CI verweisen:
        1. Es werden nur CI-Übereinstimmungen herangezogen, die alle Suchelemente aus der Eingabe-Payload aufweisen, die auf das CI in der CMDB verweisen.
        2. Wenn mehrere Übereinstimmungen vorhanden sind, wird das älteste erstellte CI als finale Übereinstimmung ausgewählt.
        Wenn dies nicht erzwungen wird, reicht ein Suchelement für ein CI in der Nutzlast aus, das einem Datensatz in der Suchtabelle entspricht, um eine Übereinstimmung zu berücksichtigen:
        1. Gleicht Übereinstimmungen mit allen CIs ab, die mindestens ein Suchelement aus der Eingabe-Payload aufweisen, das auf das CI in der CMDB verweist.
        2. Wenn mehrere Übereinstimmungen vorhanden sind, werden die CIs ausgewählt, die die maximale Anzahl an Suchelementen aus der Eingabe-Payload aufweisen, die auf das CI in der CMDB verweisen.
        3. Wenn noch immer mehrere Übereinstimmungen vorhanden sind, wird das älteste erstellte CI als finale Übereinstimmung ausgewählt.
      4. Klicken Sie auf Speichern.
    10. Attribute aus der Haupttabelle und einer anderen Tabelle (Hybrid) verwenden :
      1. Legen Sie die Optionen auf der Registerkarte Allgemeine Einstellungen wie in den vorherigen Schritten beschrieben fest, und klicken Sie dann auf Weiter.
      2. Wählen Sie auf der Registerkarte Haupttabelleneinstellungen die zu verwendenden Attribute aus der aktuell ausgewählten Tabelle aus, und klicken Sie dann auf Weiter.
        „Tabelle durchsuchen“ ist auf die aktuell ausgewählte Tabelle in der CI-Klassenliste voreingestellt.
      3. Wählen Sie auf der Registerkarte Suchtabelleneinstellungen eine Tabelle durchsuchen aus, und wählen Sie dann in Kriteriumsattribute Attribute aus der angegebenen Tabelle aus.
        Tabelle durchsuchen “ muss ein Referenzfeld zu cmdb_cihaben, andernfalls wird der Bezeichnereintrag als ungültig betrachtet.

        Sie können auf Erweiterte Optionen klicken und die Informationen für einen Suchbezeichner eingeben, wie im vorherigen Schritt beschrieben (scrollen Sie ggf. nach unten).

      4. Klicken Sie auf Speichern.
      Hinweis:
      Die Option Null-Attribut zulassen in der Hybridoption ist auf falsefestgelegt. Daher müssen alle ausgewählten Kriteriumsattribute aus der aktuell ausgewählten Tabelle und aus der Such-Tabelle einen Wert aufweisen. Außerdem ist das Festlegen optionaler Bedingungen nur für die Suchtabelle und nicht für die Haupttabelle verfügbar.
    11. Wahlweise: Klicken Sie im Abschnitt „Zugehörige Einträge“ auf einen vorhandenen zugehörigen Eintrag, um ihn zu bearbeiten, oder klicken Sie auf Hinzufügen, um einen zu erstellen.
      1. Aktualisieren Sie das Formular Zugehöriger Eintrag, und klicken Sie dann auf Speichern.
        Tabelle : 1. Formular „Zugehörige Einträge“
        Feld Beschreibung
        Aktiv Kontrollkästchen, das angibt, dass der zugehörige Eintrag aktiv ist.
        Zugehörige Tabelle Eine zugehörige Tabelle, die auf das CI verweist, das abgeglichen wird.
        Referenziertes Feld Ein referenziertes Feld in der Zugehörigen Tabelle, das das referenzierte CI speichern soll. Dieses Feld verweist immer auf die Tabelle „cmdb_ci“ oder auf eine untergeordnete Tabelle der Tabelle „cmdb_ci“.
        Priorität Priorität des zugehörigen Eintrags für die angegebene Zugehörige Tabelle. Regeln mit niedrigeren Prioritätszahlen werden bei der Abgleichung eines zugehörigen Elements mit einer bestimmten zugehörigen Tabelle mit höherer Priorität behandelt. Zugehörige Einträge für die angegebene zugehörige Tabelle von identischer Priorität werden nach dem Zufallsprinzip angewendet.

        Sie können zwischen den Prioritätszahlen Lücken lassen, um die Zuweisung ungenutzter Zahlen für neue Einträge zu ermöglichen, ohne die bestehende Prioritätsreihenfolge verändern zu müssen.

        Kriteriumsattribute Der Satz von Attributen, um das zugehörige Element eindeutig zu identifizieren. Attribute gehören entweder zu der aktuellen Klasse oder einer übergeordneten Klasse.
        Hinweis:
        Das Hinzufügen von Referenzfeldern als Kriteriumsattribute ist möglich. Solche Felder sind jedoch möglicherweise nicht immer wirksam:
        • In Referenzfeldern werden sys_ids gespeichert, die auf einen Datensatz in einer anderen Tabelle verweisen. Somit gelten Referenzfelder (bezüglich der Eindeutigkeit) als schwache Kriteriumsattribute für die aktuelle Tabelle.
        • Vom System werden ungültige Werte in einem Referenzfeld erkannt und dann durch „Unbekannt“ ersetzt. Beispielsweise wird ein ungültiger Wert für Model ID durch den Wert „Unbekannt“ ersetzt. Wenn für mehrere CIs dasselbe Referenzfeld auf „Unbekannt“ festgelegt ist, werden diese CIs auch zu doppelten CIs.

        Klicken Sie auf das Sperrsymbol, um Identifizierungsregelattribute anzuzeigen, hinzuzufügen oder zu entfernen.

        Null-Attribut unterstützen Wenn mindestens ein Kriteriumsattribut in der zugehörigen Tabelle nicht null ist, lassen Sie den Versuch zu, eine Übereinstimmung mit einem Bezeichner-Eintrag zu erzielen, selbst wenn Kriteriumsattribute vorliegen, die null sind.
        Filterbedingungen Fügen Sie Bedingungen hinzu, um einen Filter zum Eingrenzen der Datensätze zu erstellen, die nach einem übereinstimmenden zugehörigen Element durchsucht werden.
        Hinweis:
        Wenn Kriteriumsattribute nur zwei Attribute haben und sys_class_name eines davon ist (z. B. [name, sys_class_name], [ip_address, sys_class_name]), kann das andere Attribut nicht NULL sein, auch wenn das Attribut Null zulassen aktiviert ist. Diese Einschränkung ist darauf zurückzuführen, dass sys_class_name als ein spezielles, übereinstimmendes System-Attribut betrachtet wird.

    Beispiel

    Zum Beispiel gilt die vordefinierte Hardware-Regel für die Tabelle „Hardware“ [cmdb_ci_hardware]. Sie hat einen Identifier-Eintrag mit dem Attributkriterium Seriennummer, Seriennummerntyp, und das Feld Tabelle durchsuchen ist auf Seriennummer gesetzt.

    Das folgende Nutzlast-Snippet fügt der Klasse cmdb_ci_linux_server, die ein untergeordnetes Element der Hardware -Klasse ist, ein CI hinzu. Es zeigt auch, wie Sie zugehörige Elemente in der Payload hinzufügen können, für die Sie Zugehörige Einträge auf der Seite „CI Identifier“ für die Tabelle „Hardware“ [cmdb_ci_hardware] erstellen sollten:

    
    {
        "items": [
            {
                "className": "cmdb_ci_linux_server",
                "lookup": [
                    {
                        "className": "cmdb_serial_number",
                        "values": {
                            "serial_number": "VMware-42 21 e3 da 44 14 5a a6-56 48 2b 0a 28 53 42 4c",
                            "serial_number_type": "system",
                            "valid": "true"
                        }
                    },
                    {
                        "className": "cmdb_serial_number",
                        "values": {
                            "serial_number": "4221E3DA-4414-5AA6-5648-2B0A2853424C",
                            "serial_number_type": "uuid",
                            "valid": "true"
                        }
                    },                }
                ],
    
        “related": [
                    {
                        "className": "cmdb_ci_ucs_chassis",
                        "values": {
                            “name": “chassis1",
                            “category": “category1",
                            “short_description": “My Chassis 1"
                        }
                    },
                    {
                        "className": "cmdb_ci_ucs_chassis",
                        "values": {
                            “name": "chassis2",
                            "category": "category2",
                            "short_description": "My Chassis 2"
                        }
                    },    }
         ],
    
                "values": {
                    ......
                    "name": "xpolog2.lab3",
                    "os_name": "Linux",
                    "output": "Linux xpolog2.lab3 2.6.32-431.el6.x86_64 #1 SMP Fri Nov 22 03:15:09 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux",
                    "serial_number": "VMware-42 21 e3 da 44 14 5a a6-56 48 2b 0a 28 53 42 4c",
                    "sys_class_name": "cmdb_ci_linux_server"
                }
            }
        ]
    }
                             

    Wenn die Hardware-Regel angewendet wird, wird die Tabelle „Seriennummer“ [cmdb_serial_number] nach einer Übereinstimmung mit den im Schlüssel Suche angegebenen Werten durchsucht. Wenn Exakte Übereinstimmung mit Anzahl (Suche) aktiviert ist, muss nicht jeder Suchschlüssel eine Übereinstimmung zurückgeben, solange mindestens eine Übereinstimmung vorhanden ist. Wenn alle Übereinstimmungen auf dasselbe CI verweisen, wird dieses CI als vorhandener CI-Datensatz betrachtet. Wenn keine Übereinstimmung gefunden wird, fährt die Identifizierungssuche mit dem nächsten Regeleintrag fort. Wenn alle Regeln erschöpft sind, ohne eine Übereinstimmung zu finden, wird ein neuer CI-Datensatz in der Datenbank erstellt.

    Nächste Maßnahme

    Sie können optional eine Aufnahmeregel erstellen, um den Umfang der in der Identifizierung enthaltenen CIs einzugrenzen.