Benutzerdefinierte Ereignisse definieren

Um ein benutzerdefiniertes Ereignis zu erstellen, führen Sie die folgenden Schritte aus:

1. Klicken Sie in der Seitenleiste auf Einstellungen.

2. Klicken Sie auf Ereignisse -> Neues Ereignis.

3. Geben Sie die grundlegenden Ereignisdetails für das Ereignis an:

   • Geben Sie einen Namen und eine Beschreibung für das Ereignis ein. (Verwenden Sie in diesen Feldern keine Bindestriche, da diese bei der Suche möglicherweise zu unerwarteten Ergebnissen führen.)
   • Wählen Sie den Schweregrad des Problems aus: Warnung oder Kritisch.
   • Wählen Sie aus, ob das Ereignis als Vorfall betrachtet werden soll, und legen Sie eine Karenzzeit fest, für die mit dem Schließen des Problems gewartet wird, wenn die Bedingungen nicht mehr erfüllt sind.

4. Konfigurieren Sie die Bedingung des angepassten Ereignisses:

   Erstellen Sie eine Bedingung für das benutzerdefinierte Ereignis, indem Sie eine Datenquelle auswählen, die die Metriken bereitstellt, die zum Auslösen dieses Ereignisses verwendet werden:

   • Integrierte Messdaten: Es gibt Messdaten, die verfügbar sind, wenn die entsprechende Entität instrumentiert ist.

     • Wenn z. B. eine JVM überwacht wird, stellt Instana Messdaten bereit, wie z. B. die verwendete Speicherkapazität. Jede Entität vom Typ JVM verfügt standardmäßig über den Messwert memory.used.
     • Abgesehen davon sind einige dynamische, integrierte Messdaten mehrmals pro Entität vorhanden, eine für jede einzelne untergeordnete Entität. Ein Beispiel hierfür ist der verfügbare Plattenspeicherplatz eines Hosts. Für jeden Datenträger eines Hosts stellt Instana eigene Messdaten vom Typ fs.{device}.free bereit, z. B. fs./dev/xvda1.free. Angepasste Ereignisse können definiert werden, indem angegeben wird, welche Geräte abgeglichen werden sollen, z. B. starts with /dev.

   • Angepasste Messdaten: Diese Messdaten werden explizit von einer überwachten Anwendung bereitgestellt. Anwendungen können z. B. die folgenden angepassten Messdaten bereitstellen:

     • Dropwizard Kennzahlen
     • Finagle Kennzahlen
     • JMX-Metriken
     • Benutzerdefinierte Leistungsindikatoren in.NET
     • OpenTelemetry Kennzahlen
     • Prometheus-Metriken
     • StatsD-Metriken

   • Systemregeln:

     • Erkennung von Offline-Zuständen : Diese Regel wird aktiviert, wenn eine Entität (z. B. ein „ JVM “ oder ein Prozess) offline geht.
     • Hosts, auf denen keine übereinstimmenden Entitäten ausgeführt werden: Diese Regel ist aktiv, wenn keine übereinstimmenden Entitäten (wie z. B. JVM oder Prozess) auf einem Host ausgeführt werden, der sich im Bereich des angepassten Ereignisses befindet.
     • Hostverfügbarkeitserkennung: Diese Regel ist aktiv, wenn ein zuvor festgelegter Host für einen angegebenen Zeitraum offline ist.
     • Hosts, auf denen eine unerwartete Anzahl von Entitäten ausgeführt wird : Diese Regel wird ausgelöst, wenn eine unerwartete Anzahl von übereinstimmenden Entitäten (z. B. „ JVM “ oder „process“), die auf einem Host ausgeführt werden, in den Geltungsbereich des benutzerdefinierten Ereignisses fällt.

   Je nach Messwerttyp gibt es verschiedene Optionen zum Definieren der Bedingung, die das angepasste Ereignis auslöst. Sie können beispielsweise ein Ereignis konfigurieren, wenn die Fehlerrate innerhalb eines Zeitfensters von 5 Minuten größer als 10% ist.

   Es können maximal 5 Metrikbedingungen definiert werden. Bei Verwendung des logischen Operators AND müssen alle diese Bedingungen erfüllt sein, damit die Regel ausgelöst wird. Wenn der logische Operator OR verwendet wird, ist nur eine der Bedingungen erforderlich, um die Regel auszulösen.

   

   Wenn eine dynamische Metrik mit einer normalen Metrik wie fs.{device}.free mit cpu.usedkombiniert wird, wird die Metrik jeder Einheit einzeln mit der CPU-Metrik kombiniert. Wenn also das Metrikmuster der dynamischen Metrik mit drei Einheiten eines einzelnen Hosts übereinstimmt, können Sie bis zu drei aktive Probleme gleichzeitig anzeigen, die sich auf die folgenden Metriken beziehen:

   • fs./dev/first.free und cpu.used
   • fs./dev/second.free und cpu.used
   • fs./dev/third.free und cpu.used

5. Legen Sie den Umfang der Veranstaltung fest:

   Normalerweise möchten Sie nicht, dass ein Ereignis für alle Entitäten in Ihrer Anwendungs-oder Systemumgebung ausgelöst wird, aber Sie möchten das Ereignis auf eine bestimmte Gruppe von Entitäten beschränken. Über den Bereich können Sie definieren, für welche Entitäten das Ereignis bewertet wird:

   • Anwendungsperspektive : Verweisen Sie auf eine Anwendungsperspektive.
   • Ausgewählte Entitäten : Definieren Sie eine „Dynamic Focus“-Abfrage ( DFQ.md ). Nur Entitäten, die mit dieser Abfrage übereinstimmen, werden berücksichtigt, wenn das Ereignis bewertet wird.
   • Ausgewählte Entitäten (Bereich Hosts nach Tag): Nur Hostentitäten mit übereinstimmenden Tags werden berücksichtigt. Der Tag muss auf dem Host definiert sein und nicht auf einer Entität, die auf diesem Host ausgeführt wird.
   • Alle verfügbaren Entitäten: Keine Einschränkung. Das Ereignis wird für alle Entitäten in Ihrer Anwendung oder in Ihrer Systemumgebung bewertet.

   Einschränkung: Wenn ein angepasstes Ereignis für einen Service oder Endpunkt mit dem Bereich einer bestimmten Anwendung (entweder durch explizites Auswählen einer Anwendung oder mithilfe der Abfrage mit dynamischem Fokus) definiert ist, wird die Problemerkennung auf die Services und Endpunkte in diesem Bereich angewandt. Die KPIs für jeden ausgewählten Service oder Endpunkt basieren auf Aufrufen an die gesamte Entität, nicht nur auf Aufrufen, die im Kontext der Anwendung im jeweiligen Bereich stehen. Der Bereich wird also nur für die Entitätsauswahl verwendet, hat jedoch keine Auswirkungen auf den verwendeten KPI.

6. Vorübergehende Ereignisse konfigurieren (optional): Viele Ereignisse lösen sich von selbst schnell auf, oft innerhalb weniger Minuten, noch bevor Maßnahmen ergriffen werden können. Um Störsignale zu reduzieren, identifiziert „ Instana “ diese kurzlebigen Ereignisse anhand historischer Muster als potenzielle Transienten. Benutzer können diese in der Ereignisansicht herausfiltern. Diese Funktion ist standardmäßig aktiviert.

   • Funktion aktivieren oder deaktivieren : Verwenden Sie den Schalter, um die Funktion zu aktivieren oder zu deaktivieren (Standard: enabled).

   • Legen Sie den Schwellenwert für Transienten fest : Wählen Sie das Zeitfenster (in Minuten oder Stunden), das definiert, was als Transientenereignis gilt. Wenn die voraussichtliche Dauer eines Ereignisses unter diesem Schwellenwert liegt, wird es als vorübergehend eingestuft. Dieser Schwellenwert gibt an, wie lange Sie bereit sind zu warten, bevor Sie entscheiden, dass eine Angelegenheit Ihre Aufmerksamkeit erfordert.

   • Benachrichtigungsverhalten auswählen :

     • Sofort eine Benachrichtigung senden : Eine Benachrichtigung wird ausgelöst, sobald das Ereignis beginnt. Dies ist das Standardverhalten für reguläre Ereignisse.

     • Eine Benachrichtigung nur dann senden, wenn ein Ereignis über den Schwellenwert hinaus andauert : Benachrichtigungen werden für Ereignisse unterdrückt, von denen angenommen wird, dass sie vorübergehend sind. Wenn ein Ereignis länger als der festgelegte Schwellenwert dauert, wird eine Warnmeldung gesendet. Andernfalls wird kein Alarm ausgelöst, wenn der Wert innerhalb des Schwellenwerts bleibt – dies trägt dazu bei, Störsignale durch kurzzeitige Probleme zu reduzieren.

   Hinweis: Wenn Sie die Funktion zur Erkennung vorübergehender Ereignisse aktivieren, werden keine Ereignisse generiert. Stattdessen identifiziert und kennzeichnet die Funktion vorhandene Ereignisse als vorübergehend, was Ihnen hilft, diese zu filtern und zu analysieren. Weitere Informationen finden Sie unter „Konfigurationsübersicht“ im FAQ-Bereich.
7. Um das neue angepasste Ereignis zu speichern, klicken Sie auf Erstellen.