Nos complace anunciar el lanzamiento de nuevos endpoints en la API de Kinsta que te permiten acceder a analíticas detalladas sobre tus aplicaciones y recuperar información sobre los usuarios de tu empresa en Kinsta.

Desde el lanzamiento de nuestro servicio de Alojamiento de Aplicaciones, hemos proporcionado analíticas a nivel de aplicación que detallan el ancho de banda de tu aplicación, el tiempo de construcción, el tiempo de ejecución, el uso de CPU y memoria, el tiempo medio de respuesta, las peticiones HTTP y las peticiones más lentas a través del panel de MyKinsta (Aplicaciones > nombre de la aplicación > Analíticas).

Accede a la información analítica de cada aplicación en el panel MyKinsta
Accede a la información analítica de cada aplicación en el panel de MyKinsta.

Ahora, se puede acceder a estas métricas mediante programación a través de la API de Kinsta.

Nuevos endpoints de métricas para tus aplicaciones

Ahora puedes acceder a la siguiente información analítica a través de la API de Kinsta:

  • Ancho de banda — Total de datos transmitidos en el periodo de tiempo seleccionado.
  • Tiempo de construcción — Tiempo total que se tardó en construir tu aplicación.
  • Tiempo de ejecución — Tiempo total de ejecución de la aplicación tras su construcción y despliegue.
  • Peticiones HTTP por minuto — Media total de peticiones por minuto.
  • Tiempo medio de respuesta — El tiempo medio de respuesta de las solicitudes. (Si la consulta de tiempo de respuesta incluye el parámetro percent con valores de 95 ó 50, se devolverán los tiempos de respuesta de latencia P95 o latencia P50).
  • Peticiones más lentas — Te muestra exactamente qué respuestas son las más lentas dentro de tu aplicación.
  • Uso de CPU — La media del uso total de la CPU para el periodo de tiempo seleccionado, como porcentaje de los recursos de CPU de la instancia.
  • Uso de memoria — Media del uso total de memoria (RAM) durante el periodo de tiempo seleccionado.

La documentación de la API de Kinsta proporciona la ruta y los parámetros de consulta necesarios para acceder a estas métricas. Por ejemplo, para recuperar los datos de uso diario del ancho de banda, envía una petición GET a:

https://api.kinsta.com/v2/applications/{id}/metrics/bandwidth
Documentación de la API de Kinsta que muestra varios parámetros para recuperar información sobre métricas de ancho de banda
Documentación de la API Kinsta que muestra varios parámetros para recuperar información sobre métricas de ancho de banda.

Esta solicitud requerirá los siguientes parámetros:

  • Parámetro de ruta:
    • id — Es el ID de la aplicación y se añadirá a la URL de la API.
  • Parámetros de consulta:
    • interval_in_seconds — Es obligatorio y se mide en segundos, si quieres que el intervalo entre los valores devueltos sea de 24 horas, entonces convertirías 24 horas a segundos, que son 86400.
    • timeframe_start y timeframe_end — Estos parámetros son obligatorios, y se utiliza el formato fecha-hora ISO 8601. Tiene un formato general de YYYY-MM-DDThh:mm:ss.sssZ.

Aquí tienes un desglose detallado del formato de fecha y hora ISO 8601:

  • AAAA-MM-DD — Representa la fecha:
    • AAAA — Año de cuatro dígitos
    • MM — Mes de dos dígitos (01 a 12)
    • DD — Día del mes de dos dígitos (01 a 31)
  • T — La letra T se utiliza como separador para distinguir claramente entre las partes de fecha y hora.
  • hh:mm:ss.sss — Representa la hora:
    • hh — Hora de dos dígitos (00 a 23)
    • mm — Minuto de dos dígitos (00 a 59)
    • ss — Segundo de dos dígitos (00 a 59)
    • .sss — Milisegundos, que pueden ser de uno a tres dígitos, representando una parte fraccionaria de un segundo
  • Z — Indica que la hora está ajustada a UTC (Tiempo Universal Coordinado). Si la hora no está en UTC, también se puede incluir un desfase horario en lugar de «Z», con el formato ±hh:mm, donde «hh» representa la diferencia horaria y «mm» representa la diferencia de minutos respecto a UTC.

Volviendo a nuestro ejemplo, puedes enviar una petición GET para recuperar los datos diarios entre el 20 de abril de 2024 y el 28 de abril de 2024:

curl -i -X GET \
'https://api.kinsta.com/v2/applications/{application_id}/metrics/bandwidth?interval_in_seconds=86400&timeframe_start=2024-04-20T18%3A10%3A45.511Z&timeframe_end=2024-04-28T18%3A10%3A45.511Z' \
  -H 'Authorization: Bearer '

Sustituye {application_id} y <YOUR_TOKEN_HERE> por tu ID de aplicación y tu token de API, respectivamente. Cuando envías esta solicitud, se devuelve el siguiente formato de datos:

{
  "app": {
    "id": "MY_APP_ID",
    "display_name": "Kinsta-developer-portfolio",
    "metrics": {
      "timeframe": {
        "start": "1713571200000",
        "end": "1714262400000"
      },
      "bandwidth": [
        {
          "time": "1713571200000",
          "value": "18205"
        },
        {
          "time": "1713657600000",
          "value": "834750"
        },
        {
          "time": "1713744000000",
          "value": "146959"
        },
        {
          "time": "1713830400000",
          "value": "142413"
        },
        {
          "time": "1713916800000",
          "value": "165352"
        },
        {
          "time": "1714089600000",
          "value": "109015"
        },
        {
          "time": "1714176000000",
          "value": "628641"
        }
      ]
    }
  }
}

La respuesta especifica el inicio y el final del intervalo de tiempo basándose en lo que se envió a través de la solicitud. Si lo introduces en el constructor new Date(), obtendrás el objeto fecha/hora. Además, el ancho de banda devuelve un array de objetos que contiene la hora (marca de tiempo dada para cada día — en función del intervalo establecido) y el valor en bytes.

Cuando conviertes cada uno de estos datos según corresponda, significa lo siguiente:

Intervalo de tiempo

  • Inicio 2024-04-20 00:00:00
  • Fin: 2024-04-29 00:00:00

Ancho de banda (convertido a MB)

  • Hora: 2024-04-20 00:00:00, Valor: 0,0174 MB
  • Hora: 2024-04-21 00:00:00, Valor: 0,7961 MB
  • Hora: 2024-04-22 00:00:00, Valor: 0,1402 MB
  • Hora: 2024-04-23 00:00:00, Valor: 0,1358 MB
  • Hora: 2024-04-24 00:00:00, Valor: 0,1577 MB
  • Hora: 2024-04-26 00:00:00, Valor: 0,1040 MB
  • Hora: 2024-04-27 00:00:00, Valor: 0,5995 MB
  • Hora: 2024-04-28 00:00:00, Valor: 5,8086 MB

Esto significa que puedes obtener programáticamente información sobre cada una de estas analíticas en otra plataforma sin necesidad de navegar por el panel de MyKinsta para cada aplicación.

Por ejemplo, puedes crear un Slackbot que utilice el comando Slash de Slack para acceder a esta información desde Slack o crear un recordatorio que te informe cuando el uso diario de ancho de banda, CPU o memoria cruce un umbral determinado.

Acceder a los usuarios de la empresa con la API de Kinsta

En respuesta a las peticiones de los clientes, hemos añadido un endpoint para recuperar detalles sobre los usuarios de empresa de la cuenta Kinsta, incluyendo su nombre completo, correo electrónico y URL de la imagen del gravatar.

Esto se alinea con nuestro compromiso de priorizar las funciones basándonos en los comentarios de los usuarios. Si crees que una herramienta o endpoint específico debería incluirse en la API de Kinsta, no dudes en enviarnos tus comentarios.

Para acceder a estos datos, envía una solicitud GET a: https://api.kinsta.com/v2/company/{company_id}/users. Asegúrate de sustituir {company_id} por el ID de tu empresa. Esto devolverá una respuesta como

{
  "company": {
    "users": [
      {
        "user": {
          "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
          "email": "[email protected]",
          "image": "https://www.gravatar.com/avatar/205e460b479e2e5b48aec07710c08d50",
          "full_name": "John Doe"
        }
      }
    ]
  }
}

Empieza a utilizar la API de Kinsta hoy mismo

Para utilizar la API de Kinsta, necesitas una cuenta activa de Kinsta con al menos un sitio, aplicación o base de datos de WordPress en MyKinsta. Aquí te explicamos cómo generar una clave API:

  1. Ve a tu panel de MyKinsta.
  2. Ve a la página Claves API (Tu nombre > Configuración de la empresa > Claves API).
  3. Haz clic en Crear Clave API.
  4. Elige una fecha de caducidad o establece una fecha de inicio personalizada y un número de horas para que caduque la clave.
  5. Dale a la clave un nombre único.
  6. Haz clic en Generar.

Cuando se haya creado la clave API, asegúrate de copiarla y guardarla en un lugar seguro, ya que es la única vez que podrás verla. Te recomendamos que utilices un gestor de contraseñas como 1Password para compartirla de forma segura.

Con la API de Kinsta se pueden hacer muchas cosas. No dudes en consultar nuestra documentación para entender qué se puede hacer con la API, cómo empezar y los distintos niveles de permiso y límites de la API.

También puedes consultar nuestros registros de cambios anteriores para la API Kinsta: