Veja a utilização de recursos de pagamento mediante utilização

Esta página aplica-se ao Apigee, mas não ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Existem várias ferramentas que pode usar para ver e monitorizar a utilização dos seus recursos do Apigee. Este tópico aborda como os administradores de faturação ou da organização podem:

• Veja a utilização de recursos no Explorador de métricas
• Configure um alerta do Cloud Monitoring
• Veja a utilização de recursos por conta de faturação
• Monitorize recursos com o Cloud Audit Logging

Para ver a utilização de recursos da organização e configurar alertas, precisa das seguintes funções:

• Administrador da organização do Apigee (roles/apigee.admin)
• Logs Viewer (roles/logging.viewer)
• Leitor da conta de faturação (roles/billing.viewer)

Veja a utilização de recursos no explorador de métricas

Pode usar o explorador de métricas para ver a utilização dos recursos do Apigee que são atributos essenciais na determinação do custo no seu plano de preços de pagamento conforme o uso. Ao selecionar métricas e filtros específicos, pode gerar um relatório de utilização para unidades de implementação de fluxos partilhados/proxy do Apigee ou ambientes ativos do Apigee, ou ambos.

Para ver informações detalhadas sobre as métricas do Apigee e os respetivos valores possíveis, consulte apigee na página de métricas do Google Cloud.

Nota: as instruções abaixo descrevem como ver a utilização de recursos do Apigee no Explorador de métricas para um único Google Cloud projeto. Para ver e monitorizar a utilização em vários projetos, incluindo vários projetos na mesma conta de faturação, pode configurar um âmbito de métricas. Para obter instruções detalhadas, consulte os seguintes tópicos na documentação do Cloud Monitoring:

• (Console) Configure um âmbito de métricas
• (API) Configure um âmbito das métricas

Utilização da unidade de implementação do proxy/fluxo partilhado do Apigee

IU do Metrics Explorer

Para ver a utilização da unidade de implementação do proxy/fluxo partilhado do Apigee no explorador de métricas, siga estes passos:

1. Abra a página Monitorização > Explorador de métricas na Google Cloud Console.

   Aceda ao Metrics Explorer

2. No painel Selecionar uma métrica, expanda o menu Métrica e introduza Apigee na barra de filtro.

   Use os submenus para selecionar o tipo de recurso, a categoria e a métrica:

   1. No menu Recursos ativos, selecione Proxy do Apigee.
   2. No menu Categorias de métricas ativas, selecione Proxy.
   3. No menu Métricas ativas, selecione Detalhes do proxy do Apigee.
3. Clique em Aplicar.
4. Na secção Filtros:
   1. Use o menu Agrupar por para agrupar por etiqueta de recurso. Selecione proxy_deployment_type e env nas opções da lista para agrupar por tipo de implementação de proxy e ambiente.
   2. Clique em OK para aplicar os filtros.
5. Selecione Contagem no menu Função de agrupamento.

PromQL

Para ver a utilização da unidade de implementação do proxy/fluxo partilhado do Apigee com uma consulta PromQL:

1. Abra a página Monitorização > Explorador de métricas na Google Cloud Console.

   Aceda ao Metrics Explorer

2. Na barra de ferramentas do painel Selecionar uma métrica, selecione Editor de código.
3. Para usar o PromQL:
   1. Selecione PromQL no botão Idioma.
   2. Introduza a seguinte consulta no editor de consultas:

      count(apigee_googleapis_com:proxy_details{monitored_resource="apigee.googleapis.com/Proxy"}) by (proxy_deployment_type, env)

Utilização ativa do ambiente do Apigee

IU do Metrics Explorer

Para ver a utilização do ambiente ativo do Apigee no explorador de métricas, siga estes passos:

1. Abra a página Monitorização > Explorador de métricas na Google Cloud Console.

   Aceda ao Metrics Explorer

2. No painel Selecionar uma métrica, expanda o menu Métrica e introduza Apigee na barra de filtro.

   Use os submenus para selecionar o tipo de recurso, a categoria e a métrica:

   1. No menu Recursos ativos, selecione Ambiente do Apigee.
   2. No menu Categorias de métricas ativas, selecione Ambiente.
   3. No menu Métricas ativas, selecione Apigee active environment.
3. Clique em Aplicar.
4. Na secção Filtros:
   1. Use o menu Agrupar por para agrupar por etiqueta de recurso. Selecione type nas opções da lista para agrupar por tipo de ambiente.
   2. Clique em OK para aplicar os filtros.
5. Selecione Contagem no menu Função de agrupamento.

PromQL

Para ver a utilização do ambiente ativo do Apigee com uma consulta PromQL:

1. Abra a página Monitorização > Explorador de métricas na Google Cloud Console.

   Aceda ao Metrics Explorer

2. Na barra de ferramentas do painel Selecionar uma métrica, selecione Editor de código.
3. Para usar o PromQL:
   1. Selecione PromQL no botão Idioma.
   2. Introduza a seguinte consulta no editor de consultas:

      count(apigee_googleapis_com:environment_active{monitored_resource="apigee.googleapis.com/Environment"}) by (env, type)

Chamadas de API padrão e extensíveis

IU do Metrics Explorer

Para ver as chamadas API padrão e extensíveis por ambiente no explorador de métricas, siga estes passos:

1. Abra a página Monitorização > Explorador de métricas na Google Cloud Console.

   Aceda ao Metrics Explorer

2. No painel Selecionar uma métrica, expanda o menu Métrica e introduza Apigee na barra de filtro.

   Use os submenus para selecionar o tipo de recurso, a categoria e a métrica:

   1. No menu Recursos ativos, selecione Ambiente do Apigee.
   2. No menu Categorias de métricas ativas, selecione Ambiente.
   3. No menu Métricas ativas, selecione Apigee environment API call count.
3. Clique em Aplicar.
4. Na secção Filtros:
   1. Use o menu Agrupar por para agrupar por etiqueta de recurso. Selecione proxy_deployment_type nas opções da lista para agrupar por tipo de ambiente.
   2. Clique em OK para aplicar os filtros.
5. Selecione Soma no menu Função de agrupamento.

PromQL

Para ver chamadas de API padrão e extensíveis por ambiente com uma consulta PromQL:

1. Abra a página Monitorização > Explorador de métricas na Google Cloud Console.

   Aceda ao Metrics Explorer

2. Na barra de ferramentas do painel Selecionar uma métrica, selecione Editor de código.
3. Para usar o PromQL:
   1. Selecione PromQL no botão Idioma.
   2. Introduza a seguinte consulta no editor de consultas:

      sum(delta(apigee_googleapis_com:environment_api_call_countmonitored_resource="apigee.googleapis.com/Environment"}[1m])) by (proxy_deployment_type,env,location)

Crie um painel de controlo de métricas

O resultado gráfico do explorador de métricas no separador Gráfico representa uma métrica de indicador. Ou seja, cada ponto no gráfico regista a utilização de recursos da sua instância do Apigee em todos os ambientes em cada região no momento da medição.

Depois de configurar a vista dos dados através da seleção Recurso e métrica, pode guardar os dados num painel de controlo personalizado para referência futura. Para guardar a vista selecionada:

1. Clique no botão Guardar gráfico no painel do gráfico do separador Explorador.
2. Na caixa de diálogo Guardar gráfico, introduza as seguintes informações:
   • Campo Título do gráfico: introduza um nome para o gráfico ou use o título sugerido.
   • Menu pendente Painel de controlo: selecione um painel de controlo existente ou selecione Novo painel de controlo para criar e atribuir um nome a um novo painel de controlo. O seu gráfico vai ser guardado no painel de controlo selecionado.
3. Clique em Guardar.

Depois de guardar, pode aceder ao gráfico navegando para a página Vista geral dos painéis de controlo na Google Cloud Console e vendo o painel de controlo que selecionou.

Para saber mais sobre como criar e gerir vistas personalizadas através do Cloud Monitoring, consulte o artigo Painéis de controlo e gráficos.

Configure um alerta do Cloud Monitoring

Depois de configurar os relatórios de métricas para a utilização de recursos do Apigee no Cloud Monitoring, pode ativar políticas de alerta baseadas em métricas. Pode configurar políticas de alerta para monitorizar a utilização de recursos relevantes para o seu plano de pagamento conforme o uso e fornecer informações atempadas sobre potenciais problemas. Para mais informações, consulte o artigo Como funcionam os alertas.

Pode adicionar uma política de alertas baseada em métricas ao seu projeto do Google Cloud através da Google Cloud Console, da API Cloud Monitoring ou da CLI Google Cloud. Quando usa a Google Cloud Console, pode ativar alertas recomendados ou configurar alertas personalizados a partir da página Alertas do Cloud Monitoring.

Os passos gerais necessários para criar uma política de alerta baseada em métricas estão descritos no artigo Crie políticas de alerta de limite de métricas. Para configurar uma política de alertas especificamente com base na utilização de recursos, pode seguir os passos descritos no artigo Crie uma política de alertas.

Pode usar as mesmas métricas e filtros usados na secção anterior para personalizar o seu alerta de utilização de recursos. Por exemplo, para criar um alerta com base na utilização do proxy do Apigee, siga estes passos:

1. Abra a página Monitorização > Alertas na Google Cloud Console.

   Aceder a Alertas

2. Clique em + Criar política.
3. Na secção Selecionar uma métrica do painel Criar política, introduza Apigee na barra de filtros e, de seguida, use os submenus para selecionar o tipo de recurso, a categoria e a métrica:
   • No menu Recursos ativos, selecione Proxy do Apigee.
   • No menu Categorias de métricas ativas, selecione Proxy.
   • No menu Métricas ativas, selecione Detalhes do proxy do Apigee.
4. Na secção Adicionar filtros, use o menu Agrupar por para agrupar por etiqueta de recurso. Selecione proxy_deployment_type e env nas opções da lista para agrupar por tipo de implementação de proxy e ambiente.

Para criar um alerta com base na utilização do ambiente ativo do Apigee, selecione as métricas e os filtros usados para ver a utilização do ambiente do Apigee.

Veja a utilização de recursos por conta de faturação

Para ver a utilização de recursos por conta de faturação, siga estes passos:

1. Abra a página Faturação na Google Cloud Console.

   Aceder a Faturação

2. Se tiver mais do que uma conta de faturação, selecione Aceder à conta de faturação associada para ver a conta de faturação do projeto atual. Para localizar uma conta de faturação diferente, selecione Gerir contas de faturação e escolha a conta que quer ver.
3. Selecione Relatórios.
4. Clique em Mostrar filtros para aceder ao menu Filtros, se ainda não estiver aberto.
5. No campo Intervalo de tempo, selecione Data de utilização para ver uma imagem atual da faturação num intervalo de datas ou selecione Mês da fatura para ver a utilização faturada numa fatura específica.
6. Selecione Agrupar por > SKU.
7. Na lista pendente Serviços, selecione Apigee. É apresentada a lista de SKUs incluídos na sua fatura.
8. Para filtrar a lista de SKUs, selecione os SKUs que quer ver na lista pendente SKUs.

   Se a sua utilização de qualquer uma destas SKUs for 0, não vão aparecer no menu pendente Agrupar por > SKU.

Nota: o relatório de faturação resume os custos por região. Se o seu ambiente estiver associado a várias instâncias numa região, vai ver um aumento nas horas de utilização e no custo em conformidade.

Monitorize a utilização de recursos com o Cloud Audit Logging

Pode usar os registos de auditoria da nuvem para monitorizar a utilização de recursos que afetam a faturação de pagamento conforme a utilização. Siga estes passos para ver os registos de auditoria relevantes:

1. Abra a página Explorador de registos na Cloud Console.

   Aceda ao Explorador de registos

2. Na Consulta, use a barra de pesquisa para pesquisar eventos que afetem os seguintes recursos faturáveis:
   • Crie uma instância com ambientes anexados: google.cloud.apigee.v1.InstanceService.CreateInstanceAndAttachments
   • Atualize a instância e as respetivas associações: google.cloud.apigee.v1.InstanceService.UpdateInstanceAndAttachments
   • Elimine a instância com os ambientes anexados: google.cloud.apigee.v1.InstanceService.DeleteInstance
   • Criar associação de instância: google.cloud.apigee.v1.InstanceAttachmentService.CreateInstanceAttachment
   • Eliminar associação de instância: google.cloud.apigee.v1.InstanceAttachmentService.DeleteInstanceAttachment
   • Implemente um proxy: google.cloud.apigee.v1.DeploymentService.DeployApiProxy
   • Anule a implementação de um proxy: google.cloud.apigee.v1.DeploymentService.UndeployApiProxy
   • Implemente um fluxo partilhado: google.cloud.apigee.v1.DeploymentService.DeploySharedFlow
   • Anule a implementação de um fluxo partilhado: google.cloud.apigee.v1.DeploymentService.UndeploySharedFlow
   • Ative/desative o suplemento Apigee API Analytics ou Advanced API Security: google.cloud.apigee.v1.EnvironmentAddons.SetAddonEnablement

   Por exemplo, pode introduzir a seguinte consulta de exemplo:

   resource.type="audited_resource"
   resource.labels.method="google.cloud.apigee.v1.InstanceService.CreateInstanceAndAttachments"
   resource.labels.service="apigee.googleapis.com"

   Para mais informações sobre a utilização do Cloud Audit Logging para monitorizar recursos do Apigee, consulte as informações de registo de auditoria do Apigee.