AcquisitionUnitsService_getAcquisitionUnits

Gibt alle Erfassungseinheiten mit Verbindungsstatus, Aktualität der Berichterstattung, Betriebssystem, Version, IP-Adresse und Anzahl der zugewiesenen Datenquellen zurück.

Beispiel:

AcquisitionUnitsService_getAcquisitionUnitByUuid

Ruft die vollständigen Details für eine Erfassungseinheit ab. Wenn der Benutzer einen Namen angibt, werden zuerst die Erfassungseinheiten aufgelistet, um die UUID zu ermitteln.

Erforderliche Eingabe: uuid

AlertsService_getMetadata

Gibt gültige Feldnamen und Datentypen für Benachrichtigungen zurück. Dies sollte vor dem Abfragen von Benachrichtigungen aufgerufen werden.

AlertsService_queryForAlerts

Fragt aktive oder inaktive Warnmeldungen mit ausgewählten Attributen, Filtern, Sortierung, Zeitgrenzen und Offset-Paginierung ab.

Erforderliche Eingaben:

Optionale Eingaben sind filter, sortField, sortAscending, limit und offset. limit ist 1-500; offset ist 0-1000. Der Zeitraum sollte unter 30 Tagen liegen.

Beispiel:

AlertsService_getAlertByName

Ruft eine Warnung anhand einer Warnungs-ID im AL-123456 Format ab.

Erforderliche Eingabe: name

AlertsService_getAlertByUUID

Ruft eine Warnmeldung anhand ihrer UUID ab.

Erforderliche Eingabe: uuid

CollectorService_getDataSources

Listet konfigurierte Datensammler mit Name, Status, Hersteller, Modell, Erfassungseinheit, Version und letzter erfolgreicher Erfassung auf. Optional kann nach einer AU UUID gefiltert werden.

Beispiel:

CollectorService_getDataSourceById

Ruft einen Collector mit Konfiguration, Collection Package Status, Abfrageaktivität, erkannten Geräten, Patch-Informationen und Acquisition Unit Kontext ab.

Erforderliche Eingabe: id

Dieses Tool eignet sich für Abfrageintervalle, konfigurierte Metriken, Erfassungseinstellungen oder zur Untersuchung von Fehlern.

CollectorService_getDataSourceTypes

Listet die vom DII Collector Katalog unterstützten Produkttypen auf. Dies ist keine Liste der im Mandanten konfigurierten Collectors.

LogService_getLogTypes

Listet die im Mandanten aktuell verfügbaren Protokolltypen auf.

LogService_getLogTypeMetadata

Gibt gültige Attribute für einen Protokolltyp zurück. Vor der Suche oder Gruppierung von Ereignissen sollte diese Funktion aufgerufen werden.

Erforderliche Eingabe: type

LogService_queryLogEvents

Gibt die Protokollereignisse in absteigender Reihenfolge der Zeitstempel zurück.

Erforderliche Eingaben:

Optionale Eingaben sind attributes, filter, limit und cursor. limit liegt zwischen 1 und 200. Das Ereignisfenster darf 30 Tage nicht überschreiten. Der Cursor der vorherigen Antwort ist zu übergeben, um die nächste Seite abzurufen.

LogService_queryLogEventsCountHistogram

Gibt Zeitintervalle fester Größe mit Ereignisanzahlen zurück. Optional kann jedes Intervall nach einem gültigen gruppierbaren Attribut gruppiert werden; gruppierte Ergebnisse geben die obersten Segmente und ein __other__ Segment zurück.

Erforderliche Eingaben:

Optionale Eingaben: filter, groupBy

MaintenanceWindowService_getMaintenanceWindows

Listet aktive, nicht abgelaufene Alarmunterdrückungsfenster auf. Mit includeExpired auf true werden auch abgelaufene Fenster einbezogen.

Eine erfolgreiche leere Antwort bedeutet, dass keine passenden Wartungsfenster existieren.

MaintenanceWindowService_getMaintenanceWindowById

Ruft ein Wartungsfenster ab.

Erforderliche Eingabe: id

MonitorsService_queryMonitors

Listet DII Monitore auf. Mit isSystem werden nur Systemmonitore zurückgegeben, Systemmonitore ausgeschlossen oder alle Monitore zurückgegeben.

MonitorsService_getMonitorById

Ruft einen Monitor einschließlich seiner Beschreibung und, falls verfügbar, Korrekturhinweisen ab.

Erforderliche Eingabe: id

NotificationService_getNotificationRules

Listet Regeln auf, die übereinstimmende Warnmeldungen an Benachrichtigungsziele weiterleiten. Eine erfolgreiche leere Antwort bedeutet, dass keine übereinstimmenden Regeln existieren.

NotificationService_getNotificationRuleById

Eine Routing-Regel wird abgerufen.

Erforderliche Eingabe: id

NotificationService_getWebhooks

Listet Metadaten für Webhook-Ziele von Slack, Microsoft Teams, Discord, PagerDuty und benutzerdefinierten HTTP-Integrationen auf. Optional kann nach durch Kommas getrennten Engine-Typen gefiltert werden.

Sicherheitsanforderung: Vollständige Endpunktadressen können Anmeldeinformationen enthalten. Anwendungen und Agenten müssen das Adressfeld in den angezeigten oder weitergeleiteten Ergebnissen auslassen oder unkenntlich machen.

Sicheres Beispiel:

ObjectService_getObjectTypes

Listet die im Mandanten aktuell verfügbaren Objekttypen auf.

ObjectService_getMetadataForObjectType

Gibt gültige Attribute, Metriken, Typen und Gruppierungsfunktionen für einen Objekttyp zurück.

Erforderliche Eingabe: objectType

ObjectService_query

Ruft Objekte, ausgewählte Attribute und optionale Metriken ab. Filter, die sich auf Metriken beziehen, werden vor der Zeitfensteraggregation auf die Rohwerte angewendet.

Erforderliche Eingaben:

Optionale Eingaben umfassen metricNames, filter, sortFieldName, isSortAscending, fromTime, toTime, aggregateFunctions, limit und offset.

Unterstützte Abfrageaggregationen: MAX, MIN, AVG, SUM, LAST. limit ist 1-500. Wenn keine Zeitgrenzen angegeben werden, verwendet das Tool standardmäßig ein aktuelles Drei-Stunden-Fenster.

ObjectService_groupObjects

Objekte werden nach einem gültigen gruppierbaren Attribut gruppiert, und ausgewählte Metriken werden aggregiert. Filter werden vor der Aggregation auf die Rohwerte angewendet.

Erforderliche Eingaben:

Optionale Eingaben umfassen aggregateFunctions, filter, Sortierung, Zeitgrenzen, limit und offset.

Unterstützte Gruppenaggregationen: MAX, MIN, AVG, SUM, FIRST, CHANGE, CHANGE_RATIO.

ObjectService_queryPerformanceMetricsForObjects

Gibt Zeitreihendaten in Buckets für eine Metrik und übereinstimmende Objekte zurück.

Erforderliche Eingaben:

Optionale Eingaben umfassen filter, aggregationFunction, limit und isSortAscending. limit steuert die Anzahl der zurückgegebenen Serien und muss 1-50 sein.

Unterstützte Bucket-Aggregationen: MAX, MIN, AVG, SUM, FIRST, CHANGE, CHANGE_RATIO.

OperatorsManagement_getKubernetesCollectors

Der Clustername, der allgemeine aktuelle Status, die Operator-Version, die Version der Komponente Network Performance and Map, die Version der Komponente Change Analysis und der zuletzt gemeldete Zeitstempel werden zurückgegeben.

Beispiel: