Verwendung des Plugins Grafana zur Visualisierung von RUM-Daten
IBM® NS1 Connect® kunden, die die Real User Monitoring (RUM) Traffic Steering-Lösung Pulsar nutzen, können Leistungs- und Verfügbarkeitsdaten in Echtzeit von NS1 Connect an Grafana weiterleiten, um sie mit den Dashboard- und Visualisierungstools von Grafana zu analysieren.
Dieses Plugin bietet eine einheitliche Ansicht für die Überwachung von Diensten in Ihrem Netzwerk und ermöglicht es Ihnen, Warnmeldungen einzurichten, wenn die Daten eine Anomalie aufweisen.
Grafana unterstützt drei Arten von Plugins. Um RUM-Daten von NS1 Connect zu pushen, verwenden Sie ein Datenquellen-Plugin. Die von Grafana aufgezeichneten Datenpunkte sind auf die in NS1 Connect gespeicherten historischen Daten beschränkt. Mit anderen Worten: Das Plugin Grafana verlängert nicht die Zeitspanne, in der RUM-Daten abgefragt werden können.
Voraussetzungen
- Sie müssen die RUM-basierte Verkehrslenkungslösung in Ihrem NS1 Connect Konto aktiviert haben. Die Pulsar RUM-Verkehrssteuerung ist als Zusatzfunktion zu einem Premium-Tarif erhältlich.
- Sie müssen den Datenfluss von gemeinschaftlichen oder privaten Ressourcen mit mindestens einer Pulsar Real User Monitoring-Anwendung mit mindestens einem aktiven Auftrag konfiguriert haben.
- Sie müssen einen gültigen NS1 Connect API-Schlüssel haben.
- Sie müssen über eine funktionierende Instanz von Grafana verfügen und die erforderlichen Berechtigungen haben, um die Konfiguration zu ändern.
Vorgehensweise
- Laden Sie die neueste Version des Plugins von https://github.com/ns1/grafana-pulsar-datasource-v2.
- Dekomprimieren Sie die Datei und verschieben Sie das entpackte Verzeichnis in das in der Konfigurationsdatei Grafana angegebene Plugin-Verzeichnis.
- Bearbeiten Sie Ihre lokale grafana.ini -Datei und nehmen Sie die folgenden Änderungen vor:
[plugins] allow_loading_unsigned_plugins = ns1labs-pulsarmetrics-datasource [plugin.ns1labs-pulsarmetrics-datasource] allow_local_mode = true - Starten Sie Ihre Instanz Grafana neu.
- Navigieren Sie im Portal Grafana über das Menü in der Seitenleiste zur Seite Konfiguration, und wählen Sie dann Plugins, um eine Liste der verfügbaren Plugins anzuzeigen.
- Überprüfen Sie, ob NS1 Pulsar Metrics in der Liste der installierten Plugins enthalten ist. Wenn Sie sie nicht sehen, sehen Sie in den Protokollen von Grafana nach und suchen Sie nach einer entsprechenden Fehlermeldung.Hinweis: Möglicherweise wird eine vorübergehende unsignierte Warnung angezeigt, während sich das Plugin in der Prüfwarteschlange von Grafana Labs befindet.
- Navigieren Sie zur Registerkarte "Datenquellen" ) und klicken Sie auf "Datenquelle hinzufügen ".
- Suchen und wählen Sie die Datenquelle NS1 Pulsar Metrics (aufgeführt unter Andere ).
Eine Bestätigungsmeldung zeigt an, dass die Datenquelle erfolgreich hinzugefügt wurde, und Sie werden dann zur Konfigurationsseite des Plugins weitergeleitet.
- Geben Sie neben API-Schlüssel den NS1 Connect API-Schlüssel ein, den Sie zuvor erstellt haben. Der API-Schlüssel wird sicher in der Datenbank Grafana gespeichert. Klicken Sie nach Abschluss auf "Speichern und testen ". Grafana validiert, dass der API-Schlüssel verwendet werden kann, um Daten von NS1 Connect zu beziehen. Bei Erfolg wird eine Bestätigungsmeldung angezeigt.Hinweis: Wenn Grafana eine Fehlermeldung zurückgibt, überprüfen Sie das API-Schlüsselgeheimnis NS1 Connect oder die API-Schlüsselberechtigungen, um sicherzustellen, dass sie korrekt sind.
Klicken Sie auf "Zurück ", um zu den konfigurierten Datenquellen zurückzukehren. Die Datenquelle NS1 Connect Pulsar wird in der Liste angezeigt.
Wenn dies die einzige Datenquelle ist, die Sie installiert haben, ist sie als Standard gekennzeichnet. Wenn Sie weitere Plugins konfigurieren, können Sie eines davon als Standard festlegen.
Als nächstes erstellen Sie ein neues Panel in Grafana , um die Daten von Pulsar abzufragen.
- Erstellen Sie ein neues Grafana Dashboard oder navigieren Sie zu einem bestehenden.
- Klicken Sie auf das Symbol "Fenster hinzufügen " in der oberen rechten Ecke.
Die neuen Optionen werden über dem Dashboard angezeigt.
- Klicken Sie auf "Neues Panel hinzufügen ".
Der obige Screenshot zeigt eine Beispielabfrage mit Daten aus der Standarddatenquelle Grafana. Je nach Konfiguration kann Ihre Ansicht anders aussehen.
Klicken Sie auf das Dropdown-Menü Datenquelle (unten links unter der Registerkarte Abfrage ) und wählen Sie NS1 Pulsar Metrics. Jetzt sind alle verfügbaren Pulsar Anwendungen und Stellen zur Auswahl verfügbar. Beachten Sie, dass Sie nur die Anwendungen und Aufträge anzeigen können, die für den NS1 Connect API-Schlüssel zugänglich sind, den Sie bei der Konfiguration der Datenquelle eingegeben haben.Hinweis: Siehe Erstellen von Pulsar RUM-Anwendungen und -Aufträgen, um mehr über Pulsar Anwendungen und Aufträge zu erfahren. - Wählen Sie unter App eine Pulsar Anwendung aus. Eine Pulsar Anwendung ist eine Sammlung von Pulsar Ressourcen.
- Wählen Sie unter Auftrag einen Pulsar Auftrag aus. Ein Auftrag entspricht einer einzelnen Pulsar Ressource (z. B. CDN, Rechenzentrum, Cloud usw.), die gemessen wird. Die Ressource hostet ein Asset (z. B. ein Einzelpixelbild), um die Verfügbarkeit und Latenz zu messen, wenn das JavaScript -Tag beim Laden der Seite ausgeführt wird.
- Wählen Sie unter "Metrik" einen Metriktyp (d. h. Leistung oder Verfügbarkeit) aus der Liste aus.
- Wählen Sie unter Aggregation eine der vorberechneten Aggregationen aus ( min, max, avg, p50, p75, p90, p95, p99 ).
- Optional können Sie ein Geo und/oder ASN auswählen, um die Daten zu filtern. Es wird jedoch empfohlen, mindestens ein Geo anzugeben, um zu vermeiden, dass ein Diagramm das globale Verhalten des CDN anzeigt, was nur unter bestimmten Umständen sinnvoll ist.
- Geben Sie in der rechten Seitenleiste einen Titel für das neue Panel ein und passen Sie die Einstellungen und Präferenzen des Panels nach Bedarf an. Wahrscheinlich möchten Sie die Einheiten der Y-Achse auf Millisekunden einstellen.
- Optional können Sie zusätzliche Abfragen angeben, um Leistungs- oder Verfügbarkeitsdaten für mehrere Pulsar Anwendungen und Aufträge zu vergleichen. Weitere Informationen finden Sie unten.
- Wenn Sie fertig sind, klicken Sie auf "Übernehmen ", um Ihre Änderungen zu speichern. Klicken Sie oben rechts auf "Speichern ", wenn Sie fertig sind. Sie verlassen den Bearbeitungsmodus.
- Geben Sie einen Namen für das Dashboard ein (z. B. NS1 Pulsar ) und klicken Sie dann auf "Speichern ".
Das neue Dashboard wird mit dem gerade erstellten Panel angezeigt. Sie können das Dashboard nach Belieben ändern und weitere Felder hinzufügen.
Vergleich der RUM-Daten im Panel Grafana
Nachdem Sie ein neues Panel im Grafana Dashboard erstellt haben, können Sie die Leistungsdaten von zwei Pulsar RUM-Anwendungen und/oder -Aufträgen vergleichen. Konfigurieren Sie dazu ein neues Panel oder wählen Sie ein vorhandenes Panel aus, das mindestens einen Satz RUM-Daten anzeigt.
Klicken Sie unter der ersten Abfrage (A) auf "+ Abfrage ".
Es erscheint eine zweite Abfrage mit zusätzlichen Einstellungen.
Wählen Sie in der neuen Abfrage (B) die Anwendung und den Job aus, die Sie mit der ersten Abfrage vergleichen möchten. Jetzt zeigt das Diagramm zwei Datensätze, einen für jede definierte Abfrage.
