Önálló Node.js-adatgyűjtő beállítása helyszíni alkalmazásokhoz

Ha helyszíni környezetben telepítette a Node.js alkalmazást, úgy kell konfigurálnia a Node.js-adatgyűjtőt, hogy adatokat gyűjtsön a Node.js alkalmazásról.

Mielőtt elkezdené

  1. Győződjön meg róla, hogy a Node.js alkalmazás sikeresen futtatható helyileg. Az önálló Node.js-adatgyűjtő képes megfigyelni a Node.js 8.0.0-s változatát és annak jövőbeli javítócsomagjait, 10.0.0-s változatát és annak jövőbeli javítócsomagjait, és 12.0.0-s változatát és annak jövőbeli javítócsomagjait.
  2. Töltse le az adatgyűjtő csomagot az IBM® Marketplace. Részletes útmutatásért lásd: Ügynökök letöltése és az adatgyűjtők.

Eljárás

  1. Bontsa ki az adatgyűjtő csomag fájljait. A kibontott könyvtár tartalmazza a nodejs_datacollector_8.1.4.0.6.tgz csomagot.
  2. Állapítsa meg az alkalmazás alapkönyvtárát.
    • Tipikus Node.js alkalmazások esetén, ha a node app.js parancsot használja a Node.js alkalmazás indítására, és az app.js fő fájl a /root/nodejs_app könyvtárban található, akkor a /root/nodejs_app az alkalmazás alapkönyvtára.
    • Az IBM API Connect környezetben található kollektív tagok esetében a wlpn-server list parancs futtatásával jelenítse meg az azonos számítógépen található összes kollektív tag listáját. A kollektív tag alapkönyvtárának formátuma a következő:
      felhasználó_könyvtára/kollektív-tag_neve/package
      Ha például a parancs kimenete /root/wlpn/rock-8345a96-148538-1/package, akkor a /root/wlpn a felhasználó könyvtára és a rock-8345a96-148538-1 a kollektív tag neve.
    • Az IBM API Connect környezetben futó Developer Portal alkalmazások esetében a ps -ef | grep node parancs futtatásával állapíthatja meg az alapkönyvtárat. Ha például a következő parancskimenetet kapja, akkor az alapkönyvtár a /home/admin/bgsync és az alkalmazás fő fájlja a rest_server.js:
      admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  3. Az alkalmazás alapkönyvtárából a következő parancs futtatásával bontsa ki a fájlokat az adatgyűjtőcsomagból:
    tar -zxf nodejs_datacollector_8.1.4.0.6.tgz
  4. Bontsa ki az ibmapm.tgz fájlt a nodejs_dc mappában az alábbi parancs futtatásával:
    tar -zxf nodejs_dc/ibmapm.tgz
    Megjelenik az ibmapm mappa.
  5. A következő parancs futtatásával telepítse az adatgyűjtőt az alkalmazásba:
    npm install ./ibmapm
  6. Adja hozzá a következő sort a Node.js alkalmazás fő fájljának elejéhez:
    require('ibmapm');
    • Ha az alkalmazást a node app.js paranccsal indítja el, akkor az app.js az alkalmazás fő fájlja.
    • Az IBM API Connect környezetben található kollektív tagok esetében a fő fájl a package.json fájlban van meghatározva az alapkönyvtárban vagy annak almappáiban. A fő fájl alapértelmezésben az alapkönyvtár/server/server.js, ahol az alapkönyvtár a kollektív tag alapkönyvtára.
    • Az IBM API Connect környezetben futó Developer Portal alkalmazások esetében a ps -ef | grep node parancs futtatásával állapíthatja meg a fő fájlt. Ha például a következő parancskimenetet kapja, akkor az alkalmazás fő fájlja a rest_server.js.
      admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  7. Indítsa újra az alkalmazást.
    Tipp:
    • A kollektív tag újraindításához futtassa a wlpn-server stop kollektív_tag_neve parancsot. A kollektív tag ennek a parancsnak a futtatása után automatikusan újraindul. Ha nem indul el, akkor a wlpn-server start kollektív_tag_neve parancs futtatásával indítsa újra saját kezűleg.
    • A Developer Portal alkalmazások újraindításához először futtassa az /etc/init.d/restservice stop parancsot az alkalmazás leállításához, majd futtassa az /etc/init.d/restservice start parancsot az alkalmazás elindításához.

Eredmények

Az adatgyűjtő beállításra került és csatlakoztatva lett a Cloud APM kiszolgálóhoz.

Mi a következő lépés?

  • Ellenőrizheti az alkalmazás megfigyelési adatainak megjelenítését, amelyek a Cloud APM konzolban. Útmutatásért a Cloud APM konzol indításával kapcsolatban, tekintse meg a Cloud APM konzol indítása című témakört. Információkért az alkalmazás-szerkesztő használatával kapcsolatban, tekintse meg az Alkalmazások kezelése című részt.
  • Az API Connect környezet topológia információinak megjelenítéséhez ze a tranzakció-nyomkövetést. További útmutatást lásd a KNJ_ENABLE_TT változó leírását a következő helyen: Node.js-adatgyűjtő személyre szabása helyszíni alkalmazásokhoz.
Ne feledje: Ha alkalmazását hozzá kívánja adni a Cloud APM konzolhoz, akkor válassza ki a Node.js futási környezet lehetőséget az alkalmazásszerkesztőben.