Note
Dieses Feature befindet sich aktuell in public preview. Änderungen sind vorbehalten. Wir freuen uns über dein Feedback in dieser GitHub Community-Diskussion.
Informationen zu API-Erkenntnissen
Als GitHub Enterprise Cloud-Organisationsbesitzer können du und vorgesehene Benutzer REST-API-Aktivitäten für die gesamte Organisation oder bestimmte Apps und Benutzer anzeigen. Das hilft dabei, die Quellen der REST-API-Aktivität zu verstehen und den primären Ratenbegrenzungen entsprechend zu verwalten. Dadurch gewinnst du Einblicke in den Zeitrahmen, die Apps und die beteiligten API-Endpunkte. Weitere Informationen zu primären Ratenbegrenzungen findest du unter Ratenbegrenzungen für die REST-API.
Note
Derzeit unterstützt dieses Feature nur die core
-Kategorie der REST-API-Endpunkte und primäre Ratenbegrenzungen. API-Aktivität für das Suchen, GitHub Actions (mit dem GITHUB_TOKEN
-Geheimnis) sowie sekundäre Ratenbegrenzungen werden nicht unterstützt. Weitere Informationen zu API-Kategorien findest du unter REST-API-Endpunkte für die Ratenbegrenzung. Weitere Informationen zu primären und sekundären Ratenbegrenzungen findest du unter Ratenbegrenzungen für die REST-API.
Aktivieren des Zugriffs auf API-Erkenntnisse
Organisationsbesitzer können benutzerdefinierte Organisationsrollen erstellen, damit Mitarbeiter API-Erkenntnisse für ihre Organisation anzeigen können. Wähle beim Erstellen einer benutzerdefinierten Organisationsrolle die Berechtigung View organization API insights aus, um Benutzern Zugriff zu gewähren. Weise dann die benutzerdefinierte Rolle einem Organisationsmitglied oder Team zu. Weitere Informationen findest du unter Informationen zu benutzerdefinierten Organisationsrollen.
Warning
Die Erteilung des Zugriffs auf andere Benutzer als den Organisationsbesitzer ermöglicht es diesen, API-Erkenntnisse für alle Benutzer und Apps in der Organisation anzuzeigen. Der Datenschutz sollte daher berücksichtigt werden.
Grundlegendes zur API-Erkenntnisaggregation
Mit dem Feature für die Zeitraumauswahl kannst du API-Erkenntnisse für vordefinierte Zeiträume oder einen benutzerdefinierten Zeitraum anzeigen, wie in der folgenden Tabelle beschrieben. Standardmäßig werden Daten in koordinierter Weltzeit (Coordinated Universal Time, UTC) angezeigt. Du kannst die angezeigten Daten über das Dropdownmenü „Period“ oben rechts auf der Seite von UTC in die Zeitzone deines Browsers ändern.
Zeitraum | Beschreibung |
---|---|
Letzte 30 Minuten | Daten aus den letzten 30 Minuten bis zum Besuch der Seite. |
Letzte 1 Stunde | Daten aus der letzten Stunde bis zum Besuch der Seite. |
Last 3 hours | Daten aus den letzten 3 Stunden bis zum Besuch der Seite. |
Letzte 12 Stunden | Daten aus den letzten 12 Stunden bis zum Besuch der Seite. |
Letzte 24 Stunden | (Standard) Daten aus den letzten 24 Stunden bis zum Besuch der Seite. |
Letzte 7 Tage | Daten aus den letzten 7 Tagen bis zum Besuch der Seite. |
Letzte 31 Tage | Daten aus den letzten 31 Tagen bis zum Besuch der Seite. |
Benutzerdefiniert | Daten aus einem benutzerdefinierten Datums- und Uhrzeitbereich. Benutzerdefinierte Bereiche müssen innerhalb der letzten 31 Tage beginnen. |
Anzeigen von API-Erkenntnissen für eine Organisation
-
Wählen Sie in der oberen rechten Ecke von GitHub Ihr Profilfoto aus, und klicken Sie dann auf Ihre Organisationen.
-
Klicke auf den Namen Deiner Organisation.
-
Klicke unter dem Namen deiner Organisation auf Erkenntnisse.
-
Klicke im Navigationsmenü „Insights“ auf REST API.
-
Um einen Zeitraum auszuwählen, für den API-Erkenntnisse angezeigt werden sollen, wähle optional im Dropdownmenü Period oben rechts auf der Seite eine Option aus. Weitere Informationen findest du unter Grundlegendes zur API-Erkenntnisaggregation.
-
Um zwischen der Anzeige von Datums- und Uhrzeitangaben in koordinierter Weltzeit (UTC) oder der von deinem Browser verwendeten lokalen Zeitzone zu wechseln, wähle optional im Dropdownmenü Period oben rechts auf der Seite „UTC“ oder „Local“ aus.
-
Um auszuwählen, wie präzise REST-API-Anforderungen im Diagramm angezeigt werden sollen, wähle optional im Dropdownmenü Interval oben rechts auf der Seite eine Option aus. Große Intervalle zeigen Zusammenfassungen der API-Aktivität im Diagramm an, während kleinere Intervalle mehr Details für den ausgewählten Zeitraum anzeigen. Das Diagramm wird nicht automatisch aktualisiert, um neue Aktivitäten anzuzeigen.
Der ausgewählte Zeitraum und das ausgewählte Intervall werden automatisch Teil der Seiten-URL, sodass, wenn du die URL mit einer anderen Person teilst, dieselbe Ansicht angezeigt wird.
Anzeigen von API-Erkenntnissen für die Apps und Benutzer einer Organisation
In der Tabelle „Actors“ werden GitHub Apps und Benutzer angezeigt, die REST-API-Anforderungen in der aktuellen Organisation innerhalb des ausgewählten Zeitraums vorgenommen haben. Die Tabelle wird nicht automatisch aktualisiert, um neue Aktivitäten anzuzeigen.
- Zeige zunächst API-Erkenntnisse für eine Organisation mithilfe oben unter Anzeigen von API-Erkenntnissen für eine Organisation genannten Schritte an.
- Filtere die Apps und Benutzer, die in der Tabelle „Actors“ angezeigt werden.
- Um nach Namen zu filtern, gib die ersten Buchstaben des Namens in das Suchfeld oberhalb der Tabelle „Actors“ ein. Drücken Sie anschließend die EINGABETASTE.
- Um nach Akteurtyp (App oder Benutzer) zu filtern, wähle im Dropdownmenü Type oberhalb der oberen rechten Ecke der Tabelle „Actors“ eine Option aus.
- Um nach Anforderungstyp („all“ oder „primary-rate-limited“) zu filtern, wähle eine Option aus dem Dropdownmenü Requests über der oberen rechten Ecke der Tabelle „Actors“ aus.
Anzeigen von API-Erkenntnissen für eine bestimmte App oder einen bestimmten Benutzer in einer Organisation
- Zeige zunächst API-Erkenntnisse für eine Organisation mithilfe oben unter Anzeigen von API-Erkenntnissen für eine Organisation genannten Schritte an.
- Wähle optional eine App in der Tabelle „Actors“ aus, um die REST-API-Aktivität und alle primären Ratenbegrenzungen anzuzeigen. Die resultierende Ansicht ist auf die ausgewählte App zugeschnitten und zeigt die API-Endpunkte an, auf die sie zugegriffen hat.
- Wähle optional einen Benutzer in der Tabelle „Actors“ aus, um seine persönliche REST-API-Aktivität anzuzeigen. Die resultierende Ansicht ist auf den ausgewählten Benutzer zugeschnitten und zeigt die API-Aktivität seiner personal access tokens und Anforderungen durch OAuth apps in dessen Namen an. Beide werden auf die persönliche primäre Ratenbegrenzung eines Benutzers angerechnet. Informationen zu den primären Ratenbegrenzungen für Benutzer und OAuth apps, die in deren Namen handeln, findest du unter Ratenbegrenzungen für die REST-API.
- Klicke optional in der benutzerspezifischen Ansicht auf ein personal access token oder eine OAuth app, um die REST-API-Aktivität anzuzeigen, die im Namen des Benutzers erfolgt sind.