Daten mithilfe der Java-API überwachen

Sie können eine Datenquelle so definieren, dass die Java™-API für die Interaktion mit einer Anwendung mit langer Laufzeit auf der Java-Plattform verwendet wird. Der Agent startet die Anwendung beim Systemstart und interagiert in regelmäßigen Zeitabständen mit ihr. Wenn Sie den Agenten erstellen, generiert Agent Builder den Quellcode für die Anwendung. Sie müssen den Code anpassen, um Daten zu erfassen. Abhängig vom Code kann die Datenquelle mehrere Datasets erstellen, die eine einzelne Zeile, mehrere Zeilen oder Ereignisdaten enthalten können.

1. Klicken Sie auf der Seite Anfängliche Datenquelle für den Agenten oder der Seite Datenquellenposition im Bereich Überwachungsdatenkategorien auf die Option Angepasste Programme.
2. Klicken Sie im Bereich Datenquellen auf Java-API.
3. Klicken Sie auf Weiter.
4. Geben Sie auf der Seite Informationen zur Java-API den Namen einer Attributgruppe ein.
5. Geben Sie einen Hilfetext für die Attributgruppe ein.
6. Wählen Sie aus, wie die Attributgruppe Daten verarbeitet. Die folgenden Optionen sind verfügbar: Generiert eine einzelne Datenzeile, Kann mehrere Datenzeilen generieren oder Generiert Ereignisse. Ihre Auswahl wirkt sich auf die Java-Musteranwendung aus, die zum Ende des Assistentenprogramms erstellt wird. Weitere Informationen finden Sie in Daten senden.
7. Optional: Klicken Sie auf Erweitert, um die erweiterten Eigenschaften für die Attributgruppe zu bearbeiten. Die Option Erweitert ist verfügbar, wenn Sie für die Attributgruppe die Einstellung Kann mehrere Datenzeilen generieren oder Generiert Ereignisse auswählen.
8. Klicken Sie auf Weiter.
9. Geben Sie auf der Seite Attributinformationen das erste Attribut für die Attributgruppe an. Weitere Informationen zum Erstellen von Attributen finden Sie im Abschnitt Attribute erstellen.
10. Wählen Sie Zusätzliche Attribute hinzufügen aus und klicken Sie auf Weiter, um weitere Attribute zu dem Agenten hinzuzufügen. Verweise auf die Attribute werden in die Java-Musteranwendung integriert, die zum Ende des Assistentenprogramms erstellt wird.
11. Klicken Sie auf Weiter.
12. Geben Sie auf der Seite Globale Informationen zur Java-API-Datenquelle einen Klassennamen und einen JAR-Dateinamen ein.

    Der Klassenname muss ein vollständig qualifizierter Klassenname sein, dessen Hauptmethode (main) beim Starten von Java aufgerufen wird. Die Java-Musteranwendung wird mit der Java-Hauptmethode (main) in dieser Klasse erstellt.

    Die JAR-Datei ist das Archiv, das die Java-Klassen enthält, aus denen die Java-Anwendung besteht. Die JAR-Datei wird zusammen mit dem Agenten gepackt und installiert.

13. Optional: Definieren Sie auf der Seite Globale Informationen zur Java-API-Datenquelle im Abschnitt Fehlercodes die Fehlercodes, die die Java-Anwendung senden kann. Diese Fehlercodes werden von der Java-Anwendung gesendet, wenn sie keine Daten erfassen kann.
    Einschränkung: Ein Fehlercode darf bis zu 256 Zeichen lang sein. Nur ASCII-Buchstaben, Ziffern und Unterstreichungszeichen sind zulässig. Leerzeichen sind nicht zulässig.
    1. Klicken Sie im Bereich 'Fehlercodes' auf Hinzufügen.
    2. Geben Sie im Fenster Fehlercodedefinition für Java-API einen Anzeigewert ein.
    3. Geben Sie einen internen Wert ein. Der interne Wert muss eine ganze Zahl im Bereich von 1.000 bis 2.147.483.647 sein.
    4. Definieren Sie für jeden Fehler einen Nachrichtentext. Sie können zuvor eingegebenen Text verwenden, indem Sie den betreffenden Text in der Liste auswählen. Klicken Sie auf OK, um zur Seite Globale Informationen zur Java-API-Datenquelle zurückzukehren.
       Die Nachricht wird in der Protokolldatei des Agenten protokolliert.
    5. Ist kein passender Nachrichtentext vorhanden, müssen Sie auf Durchsuchen klicken, um den Nachrichtentext festzulegen.
       Das Listenfenster 'Messages' wird angezeigt. Das Nachrichtenfenster listet die im Agenten definierten Nachrichten auf. Solange Sie keine Nachrichten definiert haben, ist die Liste leer. Nach Auswahl von Bearbeiten können Sie eine definierte Nachricht ändern. Mit Entfernen können Sie eine oder mehrere definierte Nachrichten löschen.
    6. Klicken Sie im Listenfenster 'Nachrichten' auf Hinzufügen, um das Fenster Nachrichtendefinition zu öffnen. Im Fenster Nachrichtendefinition können Sie den Text eingeben, der die Bedeutung der neuen Nachricht beschreibt, und einen Nachrichtentyp auswählen.
       Anmerkung: Die Nachrichtenkennung wird automatisch generiert.
    7. Klicken Sie auf OK.
    8. Das Listenfenster 'Nachrichten' wird mit der neuen Nachricht angezeigt. Klicken Sie auf OK, um die Nachricht zu bestätigen und zur Seite Globale Informationen zur Java-API-Datenquelle zurückzukehren.
14. Optional: Im Abschnitt Ergänzungsdateien der Seite Globale Informationen zur Java-API-Datenquelle können Sie Dateien hinzufügen, die mit dem Agenten gepackt und bei der Agenteninstallation auf das Agentensystem kopiert werden. Die JAR-Datei der Client-API des Java-Providers ist hier nicht aufgeführt, da sie automatisch in das Agentensystem kopiert wird. In der Spalte Dateityp wird beschrieben, wie die einzelnen Dateien verwendet werden sollen. Die folgende Tabelle (Tabelle 1) enthält Informationen zu den drei Verwendungsmöglichkeiten. Klicken Sie auf Bearbeiten, um die importierte Datei zu bearbeiten. Weitere Informationen hierzu finden Sie im Abschnitt Befehlsdateidefinition bearbeiten.

    Tabelle 1. Dateitypen für Ergänzungsdateien

    Dateityp	Beschreibung
    Ausführbare Datei	Wählen Sie diese Option aus, um eine ausführbare Datei mit dem Agenten zu packen. Diese Datei wird vom Agenten nicht verwendet; sie ist jedoch im Pfad verfügbar, damit sie von der Java-Anwendung verwendet werden kann.
    Bibliothek	Wählen Sie diese Option aus, um eine Bibliothek mit dem Agenten zu packen. Diese Datei wird vom Agenten nicht verwendet; sie ist jedoch im Bibliothekspfad verfügbar, damit sie von der Java-Anwendung verwendet werden kann.
    Java-Ressource	Wählen Sie diese Option aus, um Java-Ressourcen mit dem Agenten zu packen. Diese Datei wird vom Agenten nicht verwendet; sie ist jedoch im Klassenpfad verfügbar, damit sie von der Java-Anwendung verwendet werden kann.

    Anmerkung: Wenn eine Java-Ressource als Ergänzungsdatei zu Agent Builder hinzugefügt wird, wird die Datei automatisch zum Projektklassenpfad hinzugefügt. Der Java-Compiler verwendet die Ergänzungsdatei, um alle in Ihrem Code enthaltenen Verweise als Klassen in der Ressource aufzulösen.

    Informationen zur Installationsposition der Ergänzungsdateien innerhalb des Agenten finden Sie in Neue Dateien auf dem System.
15. Optional: Erstellen Sie einen Filter, um die Menge der von dieser Attributgruppe zurückgegebenen Daten zu begrenzen, wenn Daten durch Stichproben erfasst werden. Zum Erstellen eines Filters klicken Sie auf Erweitert.
    Anmerkung: Die Daten werden durch Stichproben erhoben, wenn Sie nicht die Option Generiert Ereignisse auf der Seite Informationen zur Java-API ausgewählt haben.

    Weitere Informationen zum Filtern von Daten einer Attributgruppe finden Sie in Attributgruppen filtern.
16. Optional: Fügen Sie dem Unterknoten Konfigurationseigenschaften hinzu.
    Wenn Sie die Datenquelle zu einem Unterknoten hinzufügen, wird die Seite Überschreibwerte für die Unterknotenkonfiguration angezeigt, sodass Sie Konfigurationseigenschaften zum Unterknoten hinzufügen können. Unter dem Unterknoten für die zu erstellende Java-Musteranwendung muss mindesten eine Konfigurationseigenschaft vorhanden sein, da die Musteranwendung die einzelnen Unterknoteninstanzen mithilfe einer Konfigurationseigenschaft voneinander unterscheidet.
17. Führen Sie einen der folgenden Schritte aus:
    1. Klicken Sie auf Weiter, wenn Sie den Assistenten für Agenten verwenden. Führen Sie den Assistenten nach Bedarf aus.
    2. Klicken Sie andernfalls auf Fertigstellen, um die Datenquelle zu speichern und den Agenteneditor zu öffnen. Wählen Sie anschließend die Option Datei > Speichern im Hauptmenü aus.
    Zu diesem Zeitpunkt generiert Agent Builder den Quellcode für die Überwachungsanwendung. Der Code befindet sich im Unterverzeichnis src unterhalb des Projektverzeichnisses. Bearbeiten Sie diesen Code, um die Überwachungsanwendung zu erstellen.