Metrikerweiterungen

Metrikerweiterungen erstellen

1. Wählen Sie im Stackmonitoring-Menü die Option Metrikerweiterungen.
2. Klicken Sie auf Metrikerweiterung erstellen. Der UI-Bereich Metrikerweiterung erstellen wird angezeigt.

3. Metrikerweiterungseigenschaften:

   1. Geben Sie einen Namen für die Metrikerweiterung ein. Der Name der Metrikerweiterung hat immer ein ME_-Präfix.
      Hinweis
      
      Der Metrikerweiterungsname muss für einen Ressourcentyp eindeutig sein.
   2. Geben Sie einen Anzeigenamen für die Metrikerweiterung ein.
   3. Geben Sie eine Beschreibung der Metrikerweiterung ein.

4. Collection-Methodeneigenschaften geben den Ressourcentyp für die erstellte Metrikerweiterung und andere Collection-Eigenschaften an:

   • Ressourcentyp: Der Ressourcentyp (z.B. Host, Container-DB), für den Sie die Metrikerweiterung erstellen. Weitere Informationen zu unterstützten Ressourcentypen und deren unterstützten Instanzeigenschaften finden Sie unter Unterstützte Ressourcentypen und deren unterstützte Instanzeigenschaften.
   • Erfassungshäufigkeit: Geben Sie an, wie oft die Metrikerweiterung erfasst werden soll.
   • Erfassungsmethode: Geben Sie den Typ der Erfassungsmethode an, die zum Erfassen der Metrikerweiterung erforderlich ist. Die folgenden Erfassungsmethoden werden unterstützt. Einzelheiten zu den einzelnen Erfassungsmethoden und Beispielen finden Sie unter Eigenschaften der Erfassungsmethode.
     1. BS-Befehl: Diese Methode führt den angegebenen BS-Befehl oder das angegebene BS-Skript aus und parst jede Befehlsausgabezeile (durch ein benutzerdefiniertes Zeichen getrennt) in mehrere Werte. Das Metrikergebnis ist eine mehrzeilige Tabelle mit mehreren Spalten.
     2. SQL: Diese Methode führt benutzerdefinierte SQL-Abfragen oder Funktions- oder SQL-Skripte für Datenbanken aus und gibt Ergebnisse in einer Metriktabelle zurück.
     3. JMX: (Java Management Extensions): Diese Methode ruft JMX-Attribute aus JMX-fähigen Servern ab und gibt diese Attribute als Metriktabelle zurück.
     4. HTTP: Diese Methode ruft den spezifischen HTTP(S)-Endpunkt auf, d.h. die URL, und verwendet die angegebene Datei JavaScript, um die Antwort als Metriktabelle zu transformieren.

5. Metriken/Dimensionen:

   Identifizieren Sie für jeden der Werte, die durch die Ausführung einer Metrikerweiterung zurückgegeben werden, ob der Wert eine Metrik oder Dimension ist, zusammen mit den zugehörigen Eigenschaften.

   Hinweis
   
   

   • Von benutzerdefinierten Skripten zurückgegebene Werte führen zu einer mehrzeiligen Tabelle mit mehreren Spalten.
   • Die Ausgabe jeder Spalte muss als Metrik oder Dimension zusammen mit den zugehörigen Attributen identifiziert werden.
   • Ein Metrikdatenpunkt muss eine Zahl sein.

   Metrikdimensionen müssen die folgenden Attribute enthalten:

   1. Name: Geben Sie den Namen der Metrik oder Dimension mit nur englischen Alphabeten in PascalCase an. Das heißt, jeder erste Buchstabe des Wortes muss ein Großbuchstabe ohne Leerzeichen oder Zahlen dazwischen sein, entsprechend den OCI-Überwachungsanforderungen. Beispiele für einen guten Metriknamen sind CpuUtilization, TotalDatabaseSize, FileSystemUsage usw.
      Hinweis
      
      

      Entwurfsmetriken können dieselben Namen für denselben Ressourcentyp haben, jedoch nicht für veröffentlichte Metriken. Wenn ein bestimmter Metrikname für einen Ressourcentyp bereits verwendet und in einer veröffentlichten Metrikerweiterung verwendet wird, kann er nicht von einer anderen Metrik verwendet werden, die zum Namen einer anderen veröffentlichten Metrikerweiterung für denselben Ressourcentyp gehört.

      Beispiel: Wenn eine veröffentlichte Metrikerweiterung ME_FirstMetricExtension für den Ressourcentyp host_linux und eine Metrik mit dem Namen MetricFirst vorhanden ist, darf keine weitere Metrikerweiterung ME_SecondMetricExtension für denselben Ressourcentyp veröffentlicht werden, host_linux, die eine Metrik mit dem Namen MetricFirst enthält.

      Dieses Constraint gilt nicht für ausgeblendete Metriken und Dimensionen.

   2. Anzeigename (optional): Geben Sie den Anzeigenamen an, falls dieser vom Namen abweicht. Der Anzeigename kann auch Leerzeichen und Zahlen enthalten.
   3. Ist Dimension?: Wählen Sie Nein aus, wenn Sie eine Metrik definieren. Wählen Sie Ja aus, wenn Sie eine Metrikdimension definieren.

      Eine Dimension ist ein Qualifier für eine Metrik und muss ein eindeutiger Wert für jede Zeile in den Ergebnissen der Metriksammlung sein. Beispiel: Eine Metrik kann der Prozentsatz der Dateisystemauslastung sein, und die Dimension ist der Dateisystemname.

   4. Ist ausgeblendet? (Erweitert): Wählen Sie Ja aus, wenn die Metrik nur in Compute-Ausdrücken verwendet wird, d.h. wenn die Metrik nur als Wert zur Berechnung einer anderen Metrik verwendet wird oder nicht an OCI Monitoring gesendet werden muss. Wählen Sie andernfalls Nein aus.
   5. Werttyp: Alle nicht ausgeblendeten Metriken müssen numerisch sein. Eine ausgeblendete Metrik oder Dimension kann String oder Number sein.
   6. Einheit : Die mit der Metrik verknüpfte Einheit. Mögliche Einheiten können je nach Metrik Latenz in Sekunden, Millisekunden, Mikrosekunden, Minuten oder Häufigkeit in Hertz oder Prozentsatz sein.
   7. Kategorie: Identifizieren Sie den Typ der Metrikdaten, die von der Metrik erfasst werden: Verfügbarkeit, Kapazität, Last, Auslastung

   8. Compute-Ausdruck: Mit Compute-Ausdrücken können Sie den Wert einer Metrik basierend auf mathematischen oder logischen Vorgängen berechnen, die für andere Metriken oder Dimensionen innerhalb derselben Metrikerweiterung ausgeführt werden. Für Compute-Ausdrücke muss zuerst mindestens eine andere Metrik definiert werden. Sie können nur die anderen Metriken enthalten, die bereits in der Metrikerweiterung definiert wurden. Zusätzliche Details finden Sie unter Compute-Ausdrücke.

6. Erstellen und testen oder erstellen Sie die Metrikerweiterung.

   • Mit Erstellen und testen können Sie die Metrikerweiterung mit einer oder mehreren Ressourcen testen und prüfen, ob die zurückgegebenen Werte korrekt sind. Basierend auf den zurückgegebenen Werten können Sie die Bearbeitung und den Test iterativ fortsetzen.

     Hinweis
     
     Beim Testen einer Metrikerweiterung wird der Management Agent neu gestartet. Daher wird empfohlen, Metrikerweiterungen für Nicht-Produktionsressourcen zu testen.
     Hinweis
     
     Wenn eine Spalte fehl am Platz ist, können Sie sie mit der Schaltfläche Metriken/Dimensionen neu anordnen beheben.

   • Mit Erstellen können Sie die Metrikerweiterungsdefinition speichern und zu einem späteren Zeitpunkt mit Ressourcen testen.

Metrikerweiterungen testen und bearbeiten

1. Nachdem Sie die Metrikerweiterung erstellt haben, hat sie den Status "Entwurf". Im Status "Entwurf" können Sie die Definition der Metrikerweiterung weiter bearbeiten und die Metrikerweiterung anhand von Ressourcen testen.
2. Beim Testen wird eine Ressource ausgewählt, auf der die Metrik getestet werden kann. Dieser Prozess kann einige Minuten dauern, da die Metrikerweiterung für die Agents der Ressource bereitgestellt und die Metriksammlung für die Ressource ausgeführt wird.
   Hinweis
   
   Die Ressourcen, auf denen Sie Metrikerweiterungen testen und später aktivieren können, müssen mit Stack Monitoring Enterprise Edition aktiviert werden. Einzelheiten finden Sie unter Konfigurieren der Lizenzierung.
   Hinweis
   
   Befolgen Sie beim Testen einer Metrikerweiterung die folgenden Richtlinien:

   • Testen Sie nicht in Produktionsumgebungen.
   • Weisen Sie eine Testressourceninstanz mit einem eigenen Management Agent zu, der für Tests dediziert ist. Eine Abfrage/ein Skript, die in der Metrikerweiterung getestet wird, kann eine schlechte Performance aufweisen und sich somit auf andere Management Agent-Funktionen auswirken.
   • Wenn das Testen zu einem Fehler führt, wiederholen Sie die Schritte zum Erstellen der Metrikerweiterungen.
   • Wenn der Test erfolgreich war, prüfen Sie, ob die zurückgegebenen Metrikwerte korrekt sind.

Metrikerweiterungen klonen

Durch das Klonen einer Metrikerweiterung kann eine neue Metrikerweiterung aus einer vorhandenen Erweiterung erstellt werden.

Wählen Sie für eine Metrikerweiterung mit dem Status "Entwurf" oder "Veröffentlicht" im Menü auf Zeilenebene die Option Klonen aus. Dadurch wird der UI-Bereich Metrikerweiterungen erstellen geöffnet. Alle Informationen aus der ursprünglichen Metrikerweiterung sind ausgefüllt, jedoch der Name, der Name der ursprünglichen Metrikerweiterung gefolgt von Clone. Bearbeiten Sie die Parameter nach Bedarf, und schließen Sie sie ab, indem Sie den restlichen Prozess für Metrikerweiterungen erstellen befolgen.

Metrikerweiterungen exportieren und importieren

Das Importieren und Exportieren von Metrikerweiterungen ermöglicht mehr Flexibilität bei der Arbeit mit Metrikerweiterungen, wie z.B. die gemeinsame Verwendung zwischen Compartments und das lokale Speichern von Metrikerweiterungen.

• So exportieren Sie Metrikerweiterungen:

  1. Wählen Sie für eine Metrikerweiterung mit dem Status "Entwurf" oder "Veröffentlicht" im Menü auf Zeilenebene die Option Exportieren aus, um die Metrikerweiterung lokal zu speichern.
  2. Der Standardname der Datei enthält einen Zeitstempel und das Präfix MetricExtensions-Export. Bearbeiten Sie bei Bedarf den Namen der Exportdatei, und klicken Sie auf Speichern.
• Um Metrikerweiterungen zu importieren, klicken Sie auf die Metrikerweiterung importieren, und wählen Sie die zu importierende Metrikerweiterungsdatei aus.
  Hinweis
  
  Stellen Sie beim Importieren einer Metrikerweiterung sicher, dass die Datei schemeVersion größer oder gleich 1.0.0 verwendet.

Unterstützte Ressourcentypen und ihre unterstützten Instanzeigenschaften

** Einige Ressourcentypen unterstützen auch die Remoteüberwachung. Sie unterstützen jedoch auch die lokale Überwachung. Daher ist der BS-Befehl nur für Ressourceninstanzen verfügbar, die lokal von ihrem jeweiligen Management Agent überwacht werden.

Eigenschaften der Erfassungsmethode

• Befehl: Der auszuführende Befehl. Beispiel:
  • /bin/bash - für Linux
  • cmd.exe - für Windows

  Die vollständige Befehlszeile wird wie folgt erstellt: Command + Script + Arguments.

  Stellen Sie vor der Verwendung eines Skripts sicher, dass der aufgerufene Befehl/das aufgerufene Skript nicht destruktiv ist.

  Hinweis
  
  Verwenden Sie Shell-Befehle im Skriptinhalt, da diese nicht direkt als Teil des Befehlswerts verwendet werden können.
• Begrenzungszeichen für Ausgabe: Die Zeichenfolge, mit der die Befehlsausgabe begrenzt wird. Ein Beispiel als Trennzeichen ist | .
• Argumente: Argumente für das Skript oder den Befehl, die durch ein Leerzeichen getrennt sind.
  Hinweis
  
  Die Instanzeigenschaft eines Ressourcentyps kann als Argument übergeben werden, indem sie in zwei %-Symbole platziert wird. Beispiel: Im Fall des Ressourcentyps host_linux ist osType eine anwendbare Instanzeigenschaft. Wenn Sie den Wert dieser Instanzeigenschaft als Argument an das Skript übergeben müssen, kann die Argumenteigenschaft auf %osType% gesetzt werden. Eine Liste der verfügbaren Instanzeigenschaften finden Sie in der Tabelle Unterstützte Ressourcentypen und deren unterstützte Instanzeigenschaften.
• Präfix für Ausgabe: Die Anfangszeichenfolge der Zeilen mit Metrikergebnissen.

  Beispiel: Wenn die Befehlsausgabe wie folgt lautet: sm_result= 3454 | abc | def, gibt die Einstellung Prefix for output = sm_result an, dass nur Zeilen, die mit sm_result beginnen, zum Erfassen von Metrikdaten verwendet werden.

• Skriptdatei: Benutzerdefiniertes Skript, das zum Generieren der Metrikdaten ausgeführt wird.

Die Erstellungsparameter einer Metrikerweiterung für einen Listener-Ressourcentyp, der die Handlerlast, maxload, eingerichtet, abgelehnt, Handler-IDs und Verbindungsrate für jeden Service mit einer BS-Befehlserfassungsmethode erfasst, werden im folgenden beschrieben:

• Metrikerweiterungseigenschaften:

  Attributname	Eigenschaftswert
  Name	ME_GetListenerDetails
  Anzeigename	Listener-Details abrufen
  Beschreibung	Eine Metrikerweiterung für den Listener-Ressourcentyp, mit der Handler-Load, Maxload, Etabliert, Abgelehnt, Handler-IDs und Verbindungsrate für jeden Service erfasst werden

• Eigenschaften der Erfassungsmethode:

  oracleHome, alias und lsnrType sind Instanzeigenschaften des Listener-Ressourcentyps, der in der Eigenschaft Argumente innerhalb von %-Symbolen verwendet wird. Hier werden %-Symbole verwendet, um die Referenzen der Instanzeigenschaften zu speichern

  Attributname	Eigenschaftswert auf UI	Eigenschaftswert in API (nur bei Abweichung von UI)
  Ressourcenart	Listener	oci_oracle_lsnr
  Erfassungsmethode	OS-Befehl	OS_COMMAND
  Collection-Häufigkeit	15 Minuten	HÄUFIGKEIT=MINUT;INTERVALL=15
  Befehl	/bin/bash
  Begrenzung	|
  Argumente	%oracleHome% %alias% %lsnrType%
  Präfix für Ausgabe	Ergebnis=
  Skriptdatei	services.sh	"content" - Muss base64-codierten Inhalt von services.sh enthalten "Name": services.sh

• Metriken/Dimensionen:

  Metrik/Dimension	Metrik-/Dimensionseigenschaften
  TotalRefusedConnections	Werttyp: Zahl Ist Dimension?: Nein Verborgen: Nein
  TotalEstablishedConnections	Werttyp: Zahl Ist Dimension?: Nein Verborgen: Nein
  MaxConnections	Werttyp: Zahl Ist Dimension?: Nein Verborgen: Nein Einheit: Verbindungen
  HandlerId	Werttyp: Zeichenfolge Dimension: Ja Verborgen: Nein
  EstablishedConnectionsRate	Werttyp: Zahl Ist Dimension?: Nein Verborgen: Nein Compute-Ausdruck: (TotalEstablishedConnections > _TotalEstablishedConnections) ? ((TotalEstablishedConnections - _TotalEstablishedConnections) / __interval) : 0 Einheit: Verbindungen pro Sekunde __interval kann zur Ableitung von Ratenmetriken verwendet werden. Bitte beachten Sie, dass __interval immer gleich der "Sekunden"-Darstellung des Feldes "Erfassungshäufigkeit" ist. Beispiel: Wenn die Sammlungshäufigkeit 15 Minuten beträgt, ist __interval 15x60, d.h. 900 Sekunden. "_", wenn einem Metriknamen ein Präfix vorangestellt wird, hat eine besondere Bedeutung. Diese Darstellung in Compute-Ausdrücken kann verwendet werden, um den Wert einer Metrik zu referenzieren, der in der letzten Collection einer Metrikerweiterung berechnet wird. Dies kann in Compute-Ausdrücken verwendet werden, um Änderungen am Wert einer bestimmten Metrik im Vergleich zum zuletzt erfassten Wert abzuleiten. Dieses spezielle Präfix kann zum Ableiten von Delta-Metriken verwendet werden.
  ActiveConnections	Werttyp: Zahl Ist Dimension?: Nein Verborgen: Nein Einheit: Verbindungen

SQL Collection-Methode

• SQL-Abfrage: Die auszuführende SQL-Abfrage. Beispiel: select a.ename, (select count(*) from emp p where p.mgr=a.empno) directs from emp a.

  PL/SQL-Anweisungen werden ebenfalls unterstützt, wenn sie verwendet werden, müssen die Eigenschaften Out-Parameterposition und Out-Parametertyp ausgefüllt werden. Bind-Variablen können mit den Eigenschaften In Parameter an eine SQL-Abfrage übergeben werden.

• SQL-Skript: Laden Sie das erforderliche SQL-Skript zur Ausführung hoch, und geben Sie die entsprechenden In- und Out-Parametereigenschaften an. Sie können entweder eine SQL-Abfrage oder ein SQL-Skript verwenden.
• In Parameter (optional): Diese können verwendet werden, um die Bind-Variable für SQL-Abfragefälle oder in Parametern für SQL-Skriptfälle bereitzustellen.
  Hinweis
  
  Diese Eigenschaft unterstützt die Verwendung von Platzhalter für Instanzeigenschaften, mit denen der Platzhalter durch den tatsächlichen Wert der Instanzeigenschaft der Ressource ersetzt werden kann, für die eine Metrik erfasst wird. Beispiel: Für oracle_psft ist db_service_name eine Instanzeigenschaft. Er kann innerhalb eines In Parameter-Wertes innerhalb eines Paares von %-(Prozentsatz-)Symbolen übergeben werden, wie %db_service_name%.
• Out-Parameterposition (optional) - Dies ist die Positionsnummer des Out-Parameters.
• Out-Parametertyp (optional) - Dies ist der Typ des Out-Parameters.

Die Erstellungsparameter einer Metrikerweiterung für den Nicht-Container-DB-Ressourcentyp, der die Wartezeit für verschiedene Wait-Klassen mit einer SQL-Erfassungsmethode erfasst, werden unten beschrieben:

• Metrikerweiterungseigenschaften:

  Attributname	Eigenschaftswert
  Name	ME_GetWaitTime
  Anzeigename	Wartezeit abrufen
  Beschreibung	Eine Metrikerweiterung für den Nicht-Container-DB-Ressourcentyp, der die Wartezeit für verschiedene Wait-Klassen

• Eigenschaften der Erfassungsmethode:

  Attributname	Eigenschaftswert auf UI	Eigenschaftswert in API (nur bei Abweichung von UI)
  Collection-Häufigkeit	1 Stunden	HÄUFIGKEIT=STÜNDLICH;INTERVALL=1
  Erfassungsmethode	SQL
  Ressourcenart	Nicht-Container-DB	oci_oracle_db
  SQL-Abfrage	WITH wait_stats AS ( SELECT inst_id, wait_class, time_waited_fg FROM TABLE ( gv$(CURSOR( SELECT to_number(userenv('INSTANCE')) AS inst_id, wait_class, time_waited_fg / 100 AS time_waited_fg FROM v$system_wait_class WHERE wait_class <> 'Idle' )) ) ), inst_list AS ( SELECT instance_number, instance_name, host_name FROM TABLE ( gv$(CURSOR( SELECT instance_number, instance_name, host_name FROM v$instance )) ) ) SELECT inst.instance_number instance_number, inst.instance_name instance_name, inst.host_name host_name, ws.wait_class wait_class, ws.time_waited_fg time_waited_fg FROM wait_stats ws, inst_list inst WHERE inst.instance_number = ws.inst_id	"content" - Muss base64-codierte SQL-Anweisung enthalten sqlType: ANWEISUNG

• Metrik/Dimensionen:

  Metrik/Dimension	Metrik-/Dimensionseigenschaften
  InstanceNumber	Werttyp: Zahl Dimension: Ja Verborgen: Nein
  InstanceName	Werttyp: Zeichenfolge Dimension: Ja Verborgen: Nein
  HostName	Werttyp: Zeichenfolge Dimension: Ja Verborgen: Nein
  WaitClass	Werttyp: Zeichenfolge Dimension: Ja Verborgen: Nein
  TimeWaitedSeconds	Werttyp: Zahl Ist Dimension?: Nein Verborgen: Nein Einheit: Sekunden

JMX-Erfassungsmethode

• MBean name - JMX MBean ObjectName oder der Tabellenname von Metric Service.
  Hinweis
  
  

  Diese Eigenschaft unterstützt die Verwendung von Platzhalter für Instanzeigenschaften, mit denen der Platzhalter durch den tatsächlichen Wert der Instanzeigenschaft der Ressource ersetzt werden kann, für die eine Metrik erfasst wird. Beispiel: Für weblogic_j2eeserver ist service_url eine Instanzeigenschaft. Sie kann innerhalb der Zeichenfolge für den Namenswert MBean innerhalb von %-Symbolen übergeben werden, wie %service_url%.

  JMX-Attribute und Identity-Spalten unterstützen auch die Verwendung des Instance-Eigenschaftsplatzhalters.

• JMX-Attribute: Java Management Extensions-(JMX-)Attribute. Liste der JMX-Attribute oder Metrik Service-Spalten, durch Semikolon getrennt.
• Identitätsspalte (Optional) - Durch Semikolon getrennte Liste der Schlüsseleigenschaften von Managed Bean ObjectName, die als Schlüsselkennzahlen verwendet werden sollen.
• Präfix für automatische Zeilen(Optional) - Dieses Präfix wird für eine automatisch generierte Zeile als Schlüsselmetriken verwendet. Beispiel: Wenn er auf ShipItem- gesetzt ist, werden die Werte auf ShipItem-0, ShipItem-1 usw. festgelegt.
• Metrikservice auf Serverdomain aktiviert? (Optional) - Gibt an, ob Metrikservice auf Serverdomain aktiviert ist. Wenn dieser Wert auf "true" gesetzt ist, muss die Grundeigenschaft MBean name den Tabellennamen Metric Service darstellen, und die Grundeigenschaft JMX attributes steht für eine durch Semikolon getrennte Liste mit Spaltennamen für die Tabelle MetricService.
  Hinweis
  
  Aktivieren Sie diese Option nur, wenn Metrikservice für den Ressourcentyp anwendbar und in den Serverdomains aktiviert ist.

Die Erstellungsparameter einer Metrikerweiterung für den Ressourcentyp "oracle weblogic server", der die Erfassungszeit des Garbage Collectors mit der JMX-Erfassungsmethode erfasst.

• Metrikerweiterungseigenschaften:

  Attributname	Eigenschaftswert
  Name*	ME_TotalGcExecutionTime
  Anzeigename*	Gesamte Garbage Collection-Zeit abrufen
  Beschreibung	Eine Metrikerweiterung für den Ressourcentyp "oracle weblogic server", der die Ausführungszeit der Garbage Collection insgesamt

• Eigenschaften der Erfassungsmethode:

  Hier ist name eine Instanzeigenschaft von Oracle Weblogic Server und wird innerhalb des %-Instanzeigenschaftsplatzhalters innerhalb des Mbean name-Attributs der Metrikerweiterungsdefinition des JMX-Typs verwendet.

  Attributname	Eigenschaftswert auf UI	Eigenschaftswert in API (nur bei Abweichung von UI)
  Ressourcenart	Oracle WebLogic Server	weblogic_j2eeserver
  Erfassungsmethode	JMX
  Collection-Häufigkeit	1 Tage	HÄUFIGKEIT=TÄGLICH;INTERVALL=1
  MBean-Name	java.lang:Speicherort=%name%,Typ=GarbageCollector,*
  JMX-Attribute	CollectionTime
  Identitätsspalte	Name;Standort

• Metriken/Dimensionen:

  Metrik/Dimension	Metrik-/Dimensionseigenschaften
  ServerName	Werttyp: Zeichenfolge Dimension: Ja Verborgen: Nein
  ServerRuntime	Werttyp: Zeichenfolge Dimension: Ja Verborgen: Nein
  TotalGCExecTime	Werttyp: Zahl Ist Dimension?: Nein Verborgen: Nein Einheit: Millisekunden

HTTP-Erfassungsmethode

• URL: Der HTTP(s)-Endpunkt, der aufgerufen werden muss, um Raw-Metrikdaten abzurufen. Beispiel: %metric_endpoint%?auto=dummy
  Hinweis
  
  Diese Eigenschaft unterstützt die Verwendung des Platzhalters für die Instanzeigenschaft, mit dem der Platzhalter durch den tatsächlichen Wert der Instanzeigenschaft der Ressource ersetzt werden kann, für die eine Metrik erfasst wird. Im obigen Beispiel ist metric_endpoint eine Instanzeigenschaft des Ressourcentyps Apache HTTP Server und wird in einem Paar von % (Prozent-)Symbolen erwähnt. Wenn die Metrikerweiterung ausgeführt wird, wird der Istwert von %metric_endpoint% durch den Instanzeigenschaftswert der jeweiligen Ressource ersetzt.
• Antworttyp: Typ der Antwort, die vom HTTP-Endpunkt zurückgegeben wird. Die folgenden Antworttypen werden unterstützt:
  • text/plain
  • text/html
  • application/json
  • application/xml
• Protokoll (optional): Dies gilt nur für Apache HTTP Server und muss entsprechend dem Protokoll festgelegt werden, das bei der Erkennung einer Apache HTTP Server-Ressource verwendet wird. http oder https sind die beiden möglichen Werte. Für alle anderen Ressourcentypen kann diese Eigenschaft nur auf https gesetzt werden. Dies ist auch der Standardwert.
  Hinweis
  
  Eine mit dem Protokollwert http definierte HTTP-Metrikerweiterung kann nur für die Apache HTTP Server-Ressourcen aktiviert werden, die mit einem übereinstimmenden Protokollwert (http bzw. https) ermittelt wurden.
• Skriptdatei: Eine JavaScript-Datei, die URL-Antwort in aussagekräftige Metrikdaten konvertiert. Diese Datei muss über eine Funktion namens runMethod mit einer vordefinierten Signatur verfügen. Diese Funktion muss immer ein zweidimensionales Array zurückgeben, das die transformierten Daten enthält, die den in der Metrikerweiterung definierten Metriken und Dimensionen genau zugeordnet sind.

  Parameter von runMethod(metricObservation, sourceProps):

  Parameter	Beschreibung
  metricObservation	Antwort von der URL, die zum Generieren von Metrikdaten erforderlich ist.
  sourceProps	Liste der Schlüssel/Wert-Paare und enthält Instanzeigenschaften der Ressource, für die Metrikerweiterung ausgeführt wird.

  Funktionale Anforderung von runMethod:

  • Parsen Sie die Antwort von der URL, die im Parameter metricObservation enthalten ist.
  • Generieren Sie erforderliche Metrik-/Dimensionsdaten, und geben Sie sie in einem zweidimensionalen Array zurück.
  • Verwenden Sie bei Bedarf sourceProps, um die funktionale Logik zu implementieren.

Beispiel:

Die Erstellungsparameter einer Metrikerweiterung für den Ressourcentyp Apache HTTP Server, mit der die CacheRetrievesCount für Hit- und Miss-Fälle mit einer HTTP-Collection-Methode erfasst werden, werden unten beschrieben:

• Metrikerweiterungseigenschaften:

  Attributname	Eigenschaftswert
  Name	ME_GetCacheRetrievesCount
  Anzeigename	Anzahl Abrufe für Cache abrufen
  Beschreibung	Eine Metrikerweiterung für den Ressourcentyp Apache HTTP Server, mit der CacheRetrievesCount für Hit- und Miss-Fälle erfasst wird

• Eigenschaften der Erfassungsmethode:

  Attributname	Eigenschaftswert auf UI	Eigenschaftswert in API (NUR, wenn er sich von UI unterscheidet)
  Erfassungshäufigkeit	1 Stunden	HÄUFIGKEIT=STÜNDLICH;INTERVALL=1
  Erfassungsmethode	HTTP
  Ressourcentyp	Apache HTTP Server	apache_http_server
  URL	%metric_endpoint%?auto=Dummy
  Antworttyp	text/plain	TEXT_PLAIN
  Protokolltyp	http
  Skriptdatei	Konstante METRIC_NAMES = ["CacheRetrieveMissCount", "CacheRetrieveHitCount"]; Funktion runMethod(metricObservation, sourceProps) { Konstantenmetriken = {}; Konstante metricOutput = metricObservation; /* Antwort auf Parse-URL in metricObservation verfügbar Nachfolgend finden Sie einen Teil der Beispielantwort: ************************ TLSSessionCacheStatus CacheType: SHMCB CacheSharedMemory: 512000 CacheCurrentEntries: 0 CacheSubcaches: 32 CacheIndexesPerSubcaches: 88 CacheIndexUsage: 0% CacheUsage: 0% CacheStoreCount: 5 CacheReplaceCount: 0 CacheExpireCount: 5 CacheDiscardCount: 0 CacheRetrieveHitCount: 0 CacheRetrieveMissCount: 104 CacheRemoveHitCount: 0 CacheRemoveMissCount: 0 ************************ */ Konstante Zeilen = metricOutput.trim().split("\n"); für (konstante Zeilen) { Konstante lineParts = line.trim().split(): "); if (lineParts.length === 2 && METRIC_NAMES.includes(lineParts[0])) { Metriken[lineParts[0]] = parseFloat(lineParts[1]); } } /* Generieren Sie ein zweidimensionales Array mit Werten für Dimension CacheRetrievesType und Metrik CacheRetrievesCount */ Rückgabe von [['Hit', Metrics["CacheRetrieveHitCount"]], ['Miss', Metrics["CacheRetrieveMissCount"]]]; }	"content" - Muss base64-codierten Inhalt der Datei JavaScript enthalten "Name": ahs_cacheRetrieves.js

• Metrik/Dimensionen:

  Metrik/Dimension	Eigenschaften von Metrik/Dimension
  CacheRetrievesType	Werttyp: Zeichenfolge Ist Dimension: Ja Ist versteckt?: Nein
  CacheRetrievesCount	Werttyp: Zahl Ist Dimension?: Nein Ist versteckt?: Nein

Compute-Ausdrücke

Um gültige Compute-Ausdrücke zu erstellen, müssen Sie Leerzeichen zwischen Operatoren und Operanden/Metriknamen angeben.

Beispiel:

((MetricA * MetricB) / MetricC)

Bitte beachten Sie die Verwendung von space zwischen MetricA und dem Symbol *. Ebenso ist ein Leerzeichen zwischen * und MetricB wichtig, zwischen schließender Klammer und /-Symbol und /-Symbol und MetricC.

In der folgenden Tabelle werden Operatoren angezeigt, die bei der Definition des Berechnungsausdrucks verwendet werden können:

Verwendung von Operatoren:

Dieses Attribut gibt die Formel für die Berechnung des Wertes der Metrik an. Metriken, die zuvor in der Metrikerweiterung definiert wurden, können an der Berechnung teilnehmen.

Einzelheiten zur Grammatik und Verwendung des Ausdrucks finden Sie in den Beispielen.

Vordefinierte Sonderwerte:

• __interval: Sammlungsintervall. Die Erfassungsfrequenz wird in Sekunden dargestellt.
• __sysdate: aktuelle Systemuhrzeit.
• _metricName : Bezieht sich auf den Wert der Metrik während der vorherigen Sammlung. Während metricName durch den tatsächlichen Metriknamen ersetzt werden muss.
• __GMTdate: Aktuelle GMT-Zeit.
• __contains: Testet einen bestimmten Zeichenfolgenausdruck auf das Vorhandensein eines Zeichenfolgenausdrucks.
• __beginswith: Testet, ob ein bestimmter Zeichenfolgenausdruck mit einem angegebenen Zeichenfolgenausdruck beginnt.
• __endswith: Testet, ob ein bestimmter Zeichenfolgenausdruck mit dem angegebenen Zeichenfolgenausdruck endet.
• __matches: Testet, ob ein bestimmter Zeichenfolgenausdruck mit einem angegebenen Zeichenfolgenausdruck übereinstimmt.
• __delta: Berechnet die Differenz zwischen dem aktuellen Wert und dem vorherigen Wert
• __leadingchars: Gibt die führenden Zeichen in der angegebenen Zeichenfolge zurück.
• __trailingchars: Gibt die nachgestellten Zeichen in der angegebenen Zeichenfolge zurück.
• __substringpos: Gibt die Position des Vorkommens des Musters innerhalb einer angegebenen Zeichenfolge zurück.
• __is_null: Testet, ob der Ausdruck NULL ist
• __is_notnull : Testet, ob der Ausdruck NOT NULL ist
• __length: gibt die Länge des Zeichenfolgenausdrucks zurück.
• __to_upper: Konvertiert die Zeichenfolge in Großbuchstaben.
• __to_lower: Konvertiert die Zeichenfolge in Kleinbuchstaben.
• __ceil: Gibt den kleinsten Integralwert zurück, der nicht kleiner als die Kennung ist.
• __floor: Gibt den größten Integralwert zurück, der nicht größer als die ID ist.
• __round: Rundet auf nächste Ganzzahl, weg von Null.

Beispiele:

• NAME="Average" COMPUTE_EXPR="(MetricA + MetricB )/ 2"

  Der Wert der Metrik ist der Durchschnitt der beiden anderen Metriken MetricA und MetricB.

• NAME="Version" COMPUTE_EXPR="(MetricA __contains 'NetApp Release 7.') ? 7.0 : 6.0"

  Der Wert der Metrikversion wird als 7.0 berechnet, wenn die Metrik MetricA die Zeichenfolge NetApp Release 7 enthält.

• NAME="MetricA" COMPUTE_EXPR="(MetricB - MetricC)"

  Der Wert der Metrik MetricA ist der Unterschied der Spalten MetricB und MetricC.

• NAME="Status" COMPUTE_EXPR="State __matches 'STARTED'"

  Der Wert der Metrik "Status" ist 1, wenn der Wert der Spalte "Status" mit der Zeichenfolge STARTED und andernfalls 0 übereinstimmt.

• NAME="MetricA" COMPUTE_EXPR="(__is_null MetricB)?'yes':'no'"

  Der Wert der Spalte MetricA ist "Ja", wenn der Wert von Metric2 Null ist und andernfalls "Nein".

• NAME="Source" COMPUTE_EXPR="((__length result) == 0) ? 'empty' : result"

  Der Wert der Metrikquelle ist eine leere Zeichenfolge, wenn die Länge des Zeichenfolgenwertes des Metrikergebnisses 0 ist. Andernfalls ist es der Wert des Metrikergebnisses selbst.

• NAME="Rate" COMPUTE_EXPR="(__ceil (MetricA/__interval))"

  Der Wert der Metrikrate ist der Wert der Metrik MetricA geteilt durch das Erfassungsintervall, aufgerundet auf die größte Ganzzahl.

• NAME="MetricA" COMPUTE_EXPR="((MetricB == 0) ? 0 : ((MetricC / (MetricB / 8)) * 100.0))"

  Der Wert von MetricA ist 0, wenn MetricB gleich 0 ist, andernfalls ist der Wert von MetricA 100* MetricC geteilt durch 1/8 von MetricB, wobei die Berechnung auf Basis von MetricB und MetricC die obige Formel verwendet, wenn MetricB nicht gleich 0 ist, andernfalls ist es 0.

• NAME="PERCENTAGE_VALUE" COMPUTE_EXPR="(Metric1 != 0) ? 100.0*(Metric2/Metric1) : 0"

  Der Wert der Spalte ist der Gesamtprozentsatz des verfügbaren Datenträgers, wobei Metric1 und Metric2 vorhandene Metriken in der Metrikerweiterung sind.

• NAME="RATE_OF_CHANGE" COMPUTE_EXPR="((MetricA - _MetricA) / __interval)"

  Das Delta und die Rate einer Metrik können in einem Compute-Ausdruck generiert werden, indem der zuvor erfasste Wert vom aktuell erfassten Wert subtrahiert wird, um das Delta abzurufen und das Delta durch __interval dividiert wird, um die Rate zu erhalten.