Visão geral da App Optimize API

Entenda seus gastos e o uso de recursos com a API App Optimize. Google Cloud Para desenvolvedores e administradores, essa API oferece uma maneira programática de buscar dados detalhados de custo e utilização para que eles possam incorporar essas informações aos painéis, ferramentas e fluxos de trabalho diários da equipe.

A API retorna dados em um formato estruturado e tabular, semelhante aos resultados de uma consulta SQL, facilitando a análise e a ingestão em outros sistemas.

Por que usar a App Optimize API?

É possível exportar relatórios de projetos e aplicativos do App Hub para análise de tendências ou para combinar com outros dados da empresa. Você também pode usar essa API para alimentar painéis internos, impulsionar sistemas de alertas personalizados ou criar verificações de custos e utilização nos seus pipelines de implantação.

Essas integrações ajudam administradores e desenvolvedores de aplicativos a tomar decisões baseadas em dados e custos ao longo do ciclo de vida do software.

Integração com ferramentas de análise

Um caso de uso principal é a automação da exportação regular de dados de custo e utilização para uma ferramenta de análise. Ao configurar um job programado usando o Cloud Run e o Cloud Scheduler, é possível chamar a API diariamente para buscar os dados mais recentes.

Alimentar painéis personalizados

A API também pode alimentar painéis internos personalizados. Em vez de se limitarem a visualizações predefinidas do console, suas equipes podem criar aplicativos da Web que carregam de forma lenta métricas específicas de custo e utilização sob demanda. Usando JavaScript, o painel pode chamar a API e permanecer responsivo enquanto os dados são buscados em segundo plano. Isso oferece uma visão personalizada dos dados de custo e eficiência incorporados diretamente nos fluxos de trabalho da sua equipe.

Permitir decisões baseadas em dados

Ao integrar a App Optimize API aos seus sistemas, você ganha acesso flexível e automatizado aos dados necessários para um gerenciamento financeiro eficaz na nuvem e otimização de recursos. Esses padrões de acesso programático ajudam você a responder a perguntas importantes sobre eficiência de custos. É possível identificar serviços com um aumento recente nos custos, encontrar recursos subutilizados, calcular o custo exato de um aplicativo específico em um período determinado ou monitorar tendências de gastos em diferentes produtos e regiões.

Principais recursos

A API App Optimize inclui os seguintes recursos principais:

  • Relatórios detalhados. Gere relatórios que agregam dados em várias dimensões, incluindo projeto, recurso individual, SKU, período e aplicativo, serviço e carga de trabalho do App Hub.
  • Dados de custo e utilização. Acesse várias informações, como custo monetário, utilização da CPU (média e 95º percentil), uso e alocação de núcleos da CPU, utilização da memória (média e 95º percentil) e uso e alocação de memória.
  • Filtragem flexível. Use a Common Expression Language (CEL) para filtrar com precisão os dados incluídos nos seus relatórios. É possível filtrar com base em intervalos de tempo, tipos de recursos, aplicativos específicos do App Hub e outros atributos disponíveis para focar sua análise.

Entender os dados

Os relatórios gerados pela App Optimize API fornecem insights valiosos, mas é importante entender a natureza e as limitações dos dados:

Dados de custo

  • Fonte:os dados de custo se baseiam nas mesmas informações que geram seus relatórios e exportações do Cloud Billing.
  • Latência:os produtos do Google Cloud informam dados de uso e custo aos processos do Cloud Billing em intervalos variados. Pode haver um atraso entre o uso dos serviços do Google Cloud e a disponibilização do uso e dos custos nos relatórios da App Optimize API. Normalmente, os custos ficam disponíveis em um dia, mas às vezes podem demorar mais de 24 horas.
  • Custos brutos:os custos mostrados geralmente são custos brutos, refletindo o uso com os preços do contrato antes da aplicação de créditos, como descontos por uso contínuo, descontos por uso prolongado ou créditos promocionais.
  • Moeda:ao definir o escopo por um aplicativo do App Hub, todos os recursos subjacentes precisam usar a mesma moeda para que os custos sejam agregados. Se os recursos estiverem vinculados a contas de faturamento com moedas diferentes, os dados de custo desse aplicativo poderão estar incompletos ou não ser retornados.
  • Custos informados separadamente:os custos de transferência de dados e Persistent Disk são informados separadamente dos custos no nível do recurso para produtos que têm cobranças de transferência de dados ou Persistent Disk.
  • Disponibilidade:o período máximo de um filtro de relatório é de 90 dias antes da data atual. O horário de início precisa estar dentro da janela de 90 dias.
  • Categorias de produtos:os nomes de produtos usados nos relatórios da App Optimize API foram criados para serem lógicos e fáceis de usar. Elas podem agrupar custos de maneira diferente das categorias de serviço usadas nos relatórios do Cloud Billing. Por exemplo, os custos do "Compute Engine" em um relatório da App Optimize API podem abranger vários serviços subjacentes do ponto de vista do Cloud Billing.

Dados de utilização

  • Origem:as métricas de utilização são originadas do Cloud Monitoring.
  • Disponibilidade:
    • O período máximo para um filtro de relatório é de 90 dias antes da data atual. O horário de início precisa estar dentro da janela de 90 dias. As métricas do Cloud Run ficam disponíveis por seis semanas antes da data atual.
    • A disponibilidade depende do tipo de recurso e se os agentes adequados (como o Agente de operações) estão configurados para coletar métricas detalhadas.

Como a App Optimize API funciona

O processo para gerar relatórios de custos e uso tem três etapas principais:

  1. Solicite um relatório. Você especifica os dados de seu interesse, incluindo o período, os recursos ou aplicativos a serem cobertos, como agrupar os dados e os detalhes específicos de custo e uso que você quer. Depois que um relatório é criado, a definição dele não pode ser modificada. Se você precisar mudar os parâmetros, crie um novo relatório.
  2. Aguarde a preparação dos dados. Como a coleta e a organização dos dados podem levar tempo, essa etapa é executada de forma assíncrona. A API oferece uma maneira de verificar quando seu relatório está pronto.
  3. Recupere os dados do relatório. Quando o processamento for concluído, você poderá baixar o relatório, que é formatado em linhas e colunas com base na sua solicitação.

Os relatórios gerados são excluídos automaticamente da API após 24 horas.

Preços

Durante o pré-lançamento, não há custo adicional para usar a App Optimize API, incluindo a criação, leitura de relatórios e leitura de metadados de relatórios.

Para informações sobre os custos associados aos serviços Google Cloud que fornecem dados à API App Optimize, consulte o seguinte:

A seguir