Descripción general de la API de App Optimize

Comprende tu Google Cloud uso de recursos y gastos con la API de App Optimize. Para los desarrolladores y administradores, esta API ofrece una forma programática de recuperar datos detallados de costos y uso para que puedan incorporar esta información en los paneles, las herramientas y los flujos de trabajo diarios de sus equipos.

La API devuelve datos en un formato estructurado y tabular, similar a los resultados de una consulta en SQL, lo que facilita su análisis y transferencia a otros sistemas.

¿Por qué usar la API de App Optimize?

Puedes exportar informes de proyectos y aplicaciones de App Hub para realizar análisis de tendencias o unirlos con otros datos de la empresa. También puedes usar esta API para potenciar los paneles internos, impulsar sistemas de alertas personalizados o incorporar verificaciones de costos y uso en tus canalizaciones de implementación.

Estas integraciones ayudan a los administradores y desarrolladores de aplicaciones a tomar decisiones basadas en datos y en los costos a lo largo del ciclo de vida del software.

Integración con herramientas de análisis

Un caso de uso principal es la automatización de la exportación periódica de datos de costos y uso a una herramienta de análisis. Si configuras un trabajo programado con Cloud Run y Cloud Scheduler, puedes llamar a la API todos los días para recuperar los datos más recientes.

Potencia los paneles personalizados

La API también puede potenciar los paneles internos personalizados. En lugar de limitarse a las vistas prediseñadas de la consola, tus equipos pueden crear aplicaciones web que carguen de forma diferida métricas específicas de costos y utilización según demanda. Con JavaScript, el panel puede llamar a la API y seguir respondiendo mientras se recuperan los datos en segundo plano. Esto proporciona una vista personalizada de los datos de costos y eficiencia integrados directamente en los flujos de trabajo de tu equipo.

Permite tomar decisiones basadas en datos

Si integras la API de App Optimize en tus sistemas, obtendrás acceso flexible y automatizado a los datos necesarios para una administración financiera eficaz en la nube y una optimización de recursos. Estos patrones de acceso programático te ayudan a responder preguntas fundamentales sobre la eficiencia de los costos. Puedes identificar los servicios con un aumento reciente en los costos, encontrar recursos subutilizados, calcular el costo preciso de una aplicación en particular dentro de un período específico o supervisar las tendencias de gastos en diferentes productos y regiones.

Características clave

La API de App Optimize incluye las siguientes funciones clave:

  • Informes detallados: Genera informes que agregan datos en varias dimensiones, como proyecto, recurso individual, SKU, período y aplicación, servicio y carga de trabajo de App Hub.
  • Datos de costo y uso. Accede a una variedad de información, como el costo monetario, el uso de CPU (media y percentil 95), el uso y la asignación de núcleos de CPU, el uso de memoria (media y percentil 95), y el uso y la asignación de memoria.
  • Filtrado flexible: Usa Common Expression Language (CEL) para filtrar con precisión los datos incluidos en tus informes. Puedes filtrar según intervalos de tiempo, tipos de recursos, aplicaciones específicas de App Hub y otros atributos disponibles para enfocar tu análisis.

Cómo interpretar los datos

Los informes que genera la API de App Optimize proporcionan estadísticas valiosas, pero es importante comprender la naturaleza y las limitaciones de los datos:

Datos de costos

  • Fuente: Los datos de costos se basan en la misma información que alimenta tus informes y exportaciones de Facturación de Cloud.
  • Latencia: Google Cloud Los productos informan los datos de costos y de uso a los procesos de la Facturación de Cloud en intervalos variables. Es posible que veas una demora entre el uso que hagas de los servicios de Google Cloud y el momento en que el uso y los costos estén disponibles en los informes de la API de App Optimize. Por lo general, los costos están disponibles en un plazo de un día, pero, a veces, pueden tardar más de 24 horas.
  • Costos brutos: Los costos que se muestran son, por lo general, costos brutos, que reflejan el uso a los precios de tu contrato antes de que se apliquen los créditos, como los descuentos por compromiso de uso, los descuentos por uso continuo o los créditos promocionales.
  • Moneda: Cuando se define el alcance por una aplicación de App Hub, todos los recursos subyacentes de esa aplicación deben usar la misma moneda para que se agreguen los costos. Si los recursos están vinculados a cuentas de facturación con diferentes monedas, es posible que los datos de costos de esa aplicación estén incompletos o no se muestren.
  • Costos informados por separado: Los costos de transferencia de datos y de Persistent Disk se informan por separado de los costos a nivel del recurso para los productos que tienen cargos de transferencia de datos o de Persistent Disk.
  • Disponibilidad: El período máximo para un filtro de informe es de 90 días antes de la fecha actual. La hora de inicio debe estar dentro del período de 90 días.
  • Categorías de productos: Los nombres de los productos que se usan en los informes de la API de App Optimize están diseñados para ser lógicos y fáciles de usar. Es posible que estos agrupen los costos de manera diferente a las categorías de servicios que se usan en los informes de la Facturación de Cloud. Por ejemplo, los costos de "Compute Engine" en un informe de la API de App Optimize pueden abarcar varios servicios subyacentes desde la perspectiva de Facturación de Cloud.

Datos de uso

  • Fuente: Las métricas de utilización provienen de Cloud Monitoring.
  • Disponibilidad:
    • El período máximo para un filtro de informe es de 90 días antes de la fecha actual. La hora de inicio debe estar dentro del período de 90 días. Las métricas de Cloud Run solo están disponibles durante seis semanas antes de la fecha actual.
    • La disponibilidad depende del tipo de recurso y de si los agentes adecuados (como el agente de operaciones) están configurados para recopilar métricas detalladas.

Cómo funciona la API de App Optimize

El proceso de generación de informes de costos y uso tiene tres etapas principales:

  1. Solicita un informe. Especificas los datos que te interesan, incluido el período, los recursos o las aplicaciones que se deben incluir, cómo agrupar los datos y los detalles específicos de costos y uso que deseas. Una vez que se crea un informe, no se puede modificar su definición. Si necesitas cambiar los parámetros, debes crear un informe nuevo.
  2. Espera a que se preparen los datos. Dado que la recopilación y organización de los datos puede llevar tiempo, este paso se ejecuta de forma asíncrona. La API proporciona una forma de verificar cuándo está listo tu informe.
  3. Recupera los datos del informe. Una vez que finalice el procesamiento, podrás descargar el informe, que se formatea en filas y columnas según tu solicitud.

Los informes generados se borran automáticamente de la API después de 24 horas.

Precios

Durante la versión preliminar, no se aplican costos adicionales por usar la API de App Optimize, lo que incluye la creación y lectura de informes, y la lectura de metadatos de informes.

Para obtener información sobre los costos asociados con los servicios que proporcionan datos a la API de App Optimize, consulta la siguiente información: Google Cloud

¿Qué sigue?