- Den Credit-Verbrauch in deinem Workspace und nach einzelnen Nutzern zu verfolgen.
- Deinen Workspace-Credit-Pool und Credit-Limits pro Mitglied zu überwachen.
- Nutzeraktivitäten zu überwachen und inaktive Accounts zu identifizieren.
- App-Sicherheitseinstellungen zu auditieren.
- Engagement durch Aufrufe, aktive Nutzer und Nutzungstrends zu analysieren.
Workspaces
Ein Workspace ist eine gemeinsame Umgebung, in der Teams an Apps zusammenarbeiten. Die Monitoring API bietet Workspace-Inhabern und -Admins aggregierte Daten über die Nutzer und Apps in einem bestimmten Workspace.Workspace-ID
Die meisten Endpunkte erfordern eineworkspace_id im URL-Pfad, und du musst die Rolle Admin oder Inhaber in diesem Workspace haben, um auf sie zuzugreifen.
So erhältst du deine workspace_id, indem du zur Workspace-Verwaltungsseite navigierst:
- Klicke oben rechts in deinem Konto auf dein Profilsymbol.
- Bewege den Mauszeiger über den relevanten Workspace und klicke auf Manage.
- Die Workspace-ID ist der letzte Teil der URL der Workspace-Verwaltungsseite.
Credit-Pools und Mitglieds-Limits
Dein Workspace teilt für jede Credit-Reset-Periode einen einzigen Credit-Pool. Der Pool verfolgt Nachrichten- und Integrations-Credits separat, und jeder meldet sein Limit, den verbrauchten Betrag und den verbleibenden Betrag. Die Reset-Periode entspricht der auf deiner Abrechnungsseite angezeigten. Bei jährlichen Abonnements, die monatlich zurückgesetzt werden, ist dies das monatliche Fenster. Die Antwort vonGet analytics gibt diese Daten im Objekt credit_pool zurück, einschließlich deiner Stufe, der täglichen Nachrichten-Limits, Bonus-Credits, Geschenkkarten-Guthaben und Over-Limit-Flags.
Workspaces können auch Credit-Limits pro Mitglied festlegen, wie viele Nachrichten-Credits jedes Mitglied aus dem gemeinsamen Pool zieht. Das Limit eines Mitglieds stammt entweder aus einer individuellen Überschreibung oder einem Workspace-Standard. Das Objekt member_allocations in der Analytics-Antwort fasst diese Limits in deinem Workspace zusammen, und das Objekt member_allocation jedes Nutzers in Get user meldet das Limit und die Nutzung eines einzelnen Mitglieds.
Credit-Limits pro Mitglied hängen von deiner Workspace-Stufe ab. Wenn deine Stufe sie nicht unterstützt, ziehen Mitglieder ohne individuelles Limit aus dem Pool, und die Felder pro Mitglied geben
null zurück.Beispiel-Workflows
Hier sind einige gängige Anwendungen der Monitoring API.Monatliche Nutzung vergleichen
1
Aktuelle Monats-Analytics abrufen
Rufe
Get analytics mit dem
Datumsbereich dieses Monats auf, um den aktuellen Credit-Verbrauch und die Nutzeraktivität zu erhalten.2
Analytics des Vormonats abrufen
Rufe
Get analytics erneut mit
dem Datumsbereich des Vormonats auf, um Trends zu vergleichen.Nutzeraktivität analysieren
1
Nutzer auflisten
Rufe
List users auf, um alle Nutzer mit
zusammenfassenden Verbrauchsdaten für den aktuellen Abrechnungszeitraum zu erhalten.2
Nutzer abrufen
Rufe
Get user auf, um Verbrauchsdaten für
einen bestimmten Nutzer über einen benutzerdefinierten Datumsbereich zu erhalten.Mitglieder über ihrem Credit-Limit finden
1
Nutzer über ihrem Limit auflisten
Rufe
List users mit
over_member_limit=true auf, um nur Mitglieder zurückzugeben, die ihr
Credit-Limit pro Mitglied in der aktuellen Credit-Reset-Periode überschritten haben.2
Details der Mitgliederzuordnung abrufen
Rufe
Get user für ein bestimmtes Mitglied auf,
um seine member_allocation zu sehen, einschließlich des Limits, der Quelle des Limits
und der verbleibenden Credits.Eine App auditieren
1
Nutzer auflisten
Rufe
List users auf, um Nutzer in deinem
Workspace zu finden.2
Nutzer-Apps auflisten
Rufe
List user apps auf, um App-IDs
für einen bestimmten Nutzer zu erhalten.3
App-Analytics abrufen
Rufe
Get app analytics auf, um
detaillierte Metriken und Governance-Flags für die App zu erhalten.Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.