Tutorial: fazendo download e configurando um coletor de dados

Use esse tutorial para obter uma experiência prática com o download e configuração de um coletor de dados Cloud APM Bluemix Ruby do IBM® Marketplace. É possível, então, iniciar o Console do Cloud APM e verificar o funcionamento de seu recurso monitorado visualizando os principais indicadores de desempenho (KPIs) nos painéis.

1. Se não estiver conectado ao IBM Marketplace, conecte-se com seu IBMid e senha e acesse Produtos e serviços.
   A página Produtos e serviços está disponível para assinantes ativos. Se você tiver algum problema, acesse o Fórum do Cloud Application Performance Management ou o Marketplace support.
2. Faça download do pacote de Coletores de dados para aplicativos Bluemix IBM_Bluemix_Data_Collectors_Install.tgz.
3. No sistema local, navegue para o diretório onde foi salvo o archive transferido por download e extraia-o executando o seguinte comando:

   tar -zxvf IBM_Bluemix_Data_Collectors_Install.tgz

   Você obtém seus arquivos compactados, cada um representando um coletor de dados para um tipo de aplicativo Bluemix. O pacote do coletor de dados para aplicativos Ruby Bluemix é ruby_datacollector.tgz.
4. Extraia os arquivos em ruby_datacollector.tgz executando o seguinte comando, por exemplo:

   tar -zxvf ruby_datacollector.tgz

   Você obtém uma pasta ibm_ruby_dc.
5. Copie toda a pasta etc em ibm_ruby_dc para a pasta raiz de seu aplicativo Ruby executando o seguinte comando, por exemplo:

   cp –r directory to the etc folder  home directory of your Ruby application

   Se você extrair o coletor de dados no diretório /opt/ibm/ccm/ibm_ruby_dc/etc e o diretório inicial do seu aplicativo Ruby for /root/ruby_app/, o comando será como a seguir:

   cp –r /opt/ibm/ccm/ibm_ruby_dc/etc /root/ruby_app/

6. Inclua a seção a seguir no Gemfile na pasta inicial de seu aplicativo Bluemix Ruby:

   gem 'logger',  '>= 1.2.8'
   source 'https://managemserver.ng.bluemix.net' do
     gem 'ibm_resource_monitor'
     gem 'stacktracer'
   end

7. Execute o comando bundle lock para gerar novamente o arquivo Gemfile.lock.
8. No diretório inicial de seu aplicativo Ruby, execute o seguinte comando:

   cf push

9. Volte para Produtos e serviços no IBM Marketplace e clique em Ativar a partir da caixa de assinatura do Cloud APM.
   O Console do Cloud APM é aberto na página Introdução, na qual é possível aprender sobre os recursos, assistir vídeos para cenários de usuário diferentes e abrir as páginas do console associado.
10. Na página Introdução, clique em Fazer um tour do painel de gerenciamento de desempenho para um tour rápido dos elementos de navegação.
    
11. Abra o painel de resumo de aplicativos Bluemix Ruby:
    1. Na barra de navegação, clique em Desempenho > Application Performance Dashboard.
       • O painel Todos os Meus Aplicativos é exibido com uma caixa de status do resumo para cada aplicativo definido em seu ambiente. Inicialmente, somente o aplicativo predefinido Meus Componentes é exibido.
       • Se você vir uma janela Incluir Aplicativo em vez de Meus Componentes, crie um aplicativo para ver o recurso monitorado:
         1. Insira um nome para o aplicativo, tal como Meus Aplicativos.
         2. Clique em .
         3. Clique em Aplicativo Ruby Bluemix.
         4. No Editor de componente, selecione uma instância, clique em Incluir e clique em Voltar para incluir seu coletor dados no aplicativo.
         5. Clique em Salvar para fechar a janela e visualizar uma caixa de status do resumo para seu novo aplicativo no painel.
    2. Na caixa de resumo, clique em Componentes.
       • O painel de resumo para seu aplicativo Ruby Bluemix é exibido. Daqui, é possível clicar em qualquer lugar no widget de grupo de resumo de status para realizar drill down para os painéis detalhados com KPIs relatados de seu coletor de dados Ruby Bluemix.
       • Pode levar alguns minutos para que um coletor de dados recém-iniciado se comunique com a infraestrutura de monitoramento e envie KPIs para o console.