Skip to main content

Visualización de conclusiones de la API en tu organización

Puedes ver la actividad de la API REST para toda la organización o aplicaciones y usuarios específicos.

¿Quién puede utilizar esta característica?

Organization owners and users with the "View organization API insights" permission.

Your organization must be on a GitHub Enterprise Cloud plan.

Note

Esta característica se encuentra actualmente en versión preliminar pública y está sujeta a cambios. Agradecemos tus comentarios en esta discusión de la GitHub Community.

Acerca de las conclusiones de la API

Como propietario de la organización de GitHub Enterprise Cloud, tú y tus usuarios designados podéis ver la actividad de la API REST para toda la organización o aplicaciones y usuarios específicos. Esto te ayuda a comprender los orígenes de la actividad de la API REST y administrarla según tus límites de volumen principales, lo que te proporciona visibilidad sobre el período de tiempo, las aplicaciones y los puntos de conexión de API implicados. Para obtener más información sobre los límites de volumen principales, consulta "Límites de volumen de la API de REST".

Note

Actualmente, esta característica solo admite la categoría core de puntos de conexión de API de REST y los límites de frecuencia principales. No se admite la actividad de API de búsqueda, GitHub Actions (mediante el secreto GITHUB_TOKEN) y los límites de frecuencia secundarios. Para obtener información sobre las categorías de API, consulta "Puntos de conexión de la API de REST para los límites de velocidad". Para obtener más información sobre los límites de volumen principales y secundarios, consulta "Límites de volumen de la API de REST".

Habilitación del acceso a las conclusiones de la API

Los propietarios de la organización pueden crear roles de organización personalizados para permitir que los usuarios vean conclusiones de la API para su organización. Para proporcionar acceso a los usuarios, selecciona el permiso View organization API insights al crear un rol de organización personalizado. A continuación, asigna el rol personalizado a un miembro o equipo de la organización. Para obtener más información, vea «Acerca de los roles personalizados de organización».

Warning

La concesión de acceso a los no propietarios de la organización les permitirá ver conclusiones de la API para todos los usuarios y las aplicaciones de la organización, por lo que se debe tener en cuenta la privacidad.

Comprensión de la agregación de conclusiones de la API

La característica de selección de período de tiempo permite ver las conclusiones de la API durante períodos predefinidos o un período personalizado, tal como se detalla en la tabla siguiente. De forma predeterminada, los datos se presentan en hora universal coordinada (UTC). Puedes cambiar los datos que se muestran de UTC a la zona horaria del explorador en el menú desplegable "Period" en la parte superior derecha de la página.

PeríodoDescripción
Últimos 30 minutosDatos desde los últimos 30 minutos hasta el día que se ve la página.
Última horaDatos desde la última hora hasta el día que se ve la página.
Últimas 3 horasDatos desde las últimas 3 horas hasta el día que se ve la página.
Últimas 12 horasDatos desde las últimas 12 horas hasta el día que se ve la página.
Últimas 24 horas(Valor predeterminado) Datos desde las últimas 24 horas hasta el día que se ve la página.
7 últimos díasDatos desde los últimos 7 días hasta el día que se ve la página.
Últimos 31 díasDatos desde los últimos 31 días hasta el día que se ve la página.
PersonalizadoDatos de un intervalo de fecha y hora personalizado que proporciones. Los intervalos personalizados deben comenzar en los últimos 31 días.

Visualización de conclusiones de la API para una organización

  1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

  2. Haz clic en el nombre de tu organización.

  3. En el nombre del repositorio, haz clic en Información.

    Captura de pantalla de la barra de navegación horizontal de una organización. Una pestaña, etiquetada con un icono de grafo e "Información", está resaltada en naranja oscuro.

  4. En el menú de navegación "Insights", haz clic en REST API.

  5. Opcionalmente, para seleccionar un período de tiempo para ver las conclusiones de la API, elige una opción en el menú desplegable Period de la parte superior derecha de la página. Para obtener más información, consulta "Comprensión de la agregación de conclusiones de la API".

  6. Opcionalmente, para cambiar entre mostrar fechas y horas en hora universal coordinada (UTC) o la zona horaria local usada por el explorador, selecciona "UTC" o "Local" en el menú desplegable Period situado en la parte superior derecha de la página.

  7. Opcionalmente, para seleccionar con qué detalle mostrar solicitudes de la API REST en el gráfico, elige una opción en el menú desplegable Interval situado en la parte superior derecha de la página. Los intervalos grandes muestran resúmenes de la actividad de la API en el gráfico, mientras que los intervalos más pequeños muestran más detalles para el período de tiempo seleccionado. El gráfico no se actualiza automáticamente para mostrar la nueva actividad.

El período y el intervalo seleccionados se convierten automáticamente en parte de la dirección URL de la página para que, en caso de que compartas la dirección URL con alguien, vea la misma vista.

Visualización de conclusiones de la API para las aplicaciones y los usuarios de una organización

En la tabla "Actors" se muestran GitHub Apps y los usuarios que realizaron solicitudes de API REST en la organización actual en el período de tiempo seleccionado. La tabla no se actualiza automáticamente para mostrar la nueva actividad.

  1. En primer lugar, consulta las conclusiones de la API para una organización siguiendo los pasos anteriores en "Visualización de conclusiones de la API para una organización".
  2. Filtra las aplicaciones y los usuarios que se muestran en la tabla "Actors".
    1. Para filtrar por nombre, escribe las primeras letras del nombre en el campo de búsqueda situado sobre la tabla "Actors". Después, presione Entrar.
    2. Para filtrar por tipo de actor (aplicación o usuario), elige una opción en el menú desplegable Type situado encima de la parte superior derecha de la tabla "Actors".
    3. Para filtrar por tipo de solicitud (todas o limitadas por volumen principal), elige una opción en el menú desplegable Requests situado encima de la parte superior derecha de la tabla "Actors".

Visualización de conclusiones de la API para una aplicación o un usuario específicos de una organización

  1. En primer lugar, consulta las conclusiones de la API para una organización siguiendo los pasos anteriores en "Visualización de conclusiones de la API para una organización".
  2. Opcionalmente, selecciona una aplicación en la tabla "Actors" para mostrar tu actividad de la API REST y cualquier limitación de volumen principal. La vista resultante será específica de la aplicación seleccionada y mostrará los puntos de conexión de API a los que ha accedido.
  3. Opcionalmente, selecciona un usuario en la tabla "Actors" para mostrar su actividad personal de la API REST. La vista resultante será específica del usuario seleccionado y mostrará la actividad de la API de sus personal access tokens y solicitudes realizados por OAuth apps en su nombre. Ambos contribuyen al límite de volumen principal personal de un usuario. Para obtener información sobre los límites de volumen principales para los usuarios y las OAuth apps que actúan en su nombre, consulta "Límites de volumen de la API de REST".
    1. Opcionalmente, en la vista específica del usuario, haz clic en un personal access token o una OAuth app para ver su actividad de la API REST realizada en nombre del usuario.