Impact Analysis

A funcionalidade Impact Analysis (Governance  Impact Analysis) traz uma visualização gráfica da rede de integração de uma API. Ela tem dois objetivos principais:

  1. mitigar problemas com mudanças tanto nas APIs quanto em suas dependências;

  2. dar uma visão clara dos pontos a serem alterados para alcançar um determinado objetivo.

Ela consegue isso analisando toda a rede de integração dentro da API Platform a partir de uma API. O resultado é uma visualização gráfica que pode ser explorada, representando as aplicações e planos que consomem uma API e os recursos e endpoints a que a API provê acesso. Com isso, é possível ter em mente o impacto que será causado por mudanças na API ou em partes da rede integrada por ela.

Funcionamento

Para gerar a representação gráfica, o primeiro passo é informar a API desejada e o ambiente na qual ela está implantada no campo Deployed at.

impact analysis
Impact Analysis só coleta as informações em runtime — ou seja, das APIs que estão implantadas no ambiente selecionado. Não é possível fazer análise de impacto em APIs que ainda não foram implantadas.

Depois de informar a API, sua versão, o ambiente, e clicar em SEARCH, um gráfico como o do exemplo abaixo será exibido, representando a API como nó raiz, ao centro; os planos de consumo para ela, à esquerda; e seus recursos, à direita.

As versões anteriores à 4.6.2.0 não apresentam um campo para selecionar a versão da API.
impact analysis hide all

Você pode clicar em cada nó, expandindo as informações do gráfico. Ao clicar em recursos, você pode observar as operações e destinations relacionados a eles; ao clicar nos planos, o gráfico apresentará as apps com acesso à API. Ao invés de clicar em cada nó para expandir a informação parte a parte, é também possível exibir todo o conteúdo disponível do gráfico ao mesmo tempo clicando no botão EXPAND ALL, acima e à esquerda do gráfico. Para simplificar o gráfico novamente e mostrar somente planos e recursos, clique em HIDE ALL.

No exemplo abaixo, menos complexo que o da imagem acima, mostramos o gráfico expandido para uma API chamada "Photos API":

impact analysis ex

Métricas

O gráfico também exibe volumetria para os nós de APIs e operações em uma janela à direita quando você clica nos nós:

impact analysis api
impact analysis operation
As métricas exibidas são referentes ao dia corrente.

Ao clicar nos nós de destination, é possível visualizar, também em uma janela à direita, os endpoints dos recursos:

impact analysis destination

Note que, para os nós de destination, o API Manager interpreta API Destinations e os interceptores Internal API Call, Service Callout e Custom JavaScript que tenham chamadas utilizando o componente $http.

Em versões anteriores a 4.6.1.0, as informações sobre as métricas e sobre os endpoints são exibidas quando você posiciona o cursor sobre os nós:

impact analysis metrics previous
Thanks for your feedback!
EDIT
How useful was this article to you?