Konfigurowanie agenta agent dla Ruby

Aby agent dla Ruby mógł monitorować aplikacje, podaj środowisko wykonawcze Ruby. W rezultacie można użyć środowiska wykonawczego do gromadzenia danych z aplikacji Ruby i do skonfigurowania agenta.

Zanim rozpoczniesz

Określ serwer, który jest używany do uruchamiania aplikacji Ruby oraz kwalifikowany katalog bin programu wykonywalnego Ruby lub Rake, który jest używany przez agenta:
  1. Aby określić używany serwer aplikacji, uruchom następującą komendę:
    ps -ef | grep ruby
    Zostanie wyświetlona nazwa serwera, który jest używany do uruchamiania aplikacji. Możliwe nazwy serwerów są wymienione poniżej:
    • Passenger
    • Unicorn
    • Puma
    • Thin

    Jeśli dane wyjściowe komendy nie zawierają nazwy serwera z powyższej listy, serwerem używanym do uruchamiania aplikacji może być WEBrick.

    Ważne: Jeśli do uruchomienia aplikacji WWW używane jest wiele serwerów Ruby, należy utworzyć jedną instancję agenta dla każdego serwera aplikacji, na przykład jedną instancję dla usługi PUMA i jedną dla Unicorn.
  2. Aby określić pełną ścieżkę pliku wykonywalnego Ruby lub Rake, którego używa agent dla Ruby, uruchom następującą komendę:
    which ruby

O tym zadaniu

Możesz powtórzyć tę czynność w celu skonfigurowania wielu instancji agenta, zgodnie z potrzebami.

Procedura

  1. Aby skonfigurować agenta, wpisz następującą komendę:
    katalog_instalacyjny/bin/ruby-agent.sh config nazwa_instancji
    Gdzie nazwa_instancji to nazwa, która ma zostać nadana instancji, a katalog_instalacyjny to katalog instalacyjny agenta dla Ruby. Domyślny katalog instalacyjny to: /opt/ibm/apm/agent.
    Ważne: Nie podawaj za długiej nazwy instancji. Łączna długość nazwy hosta i nazwy instancji agenta nie może przekraczać 28 znaków. Jeśli długość przekracza limit, nazwa systemu zarządzanego zostanie obcięta i kod produktu dla agenta dla Ruby nie będzie wyświetlany poprawnie.

    Nazwa systemu zarządzanego zawiera podaną nazwę instancji, na przykład: nazwa_instancji:nazwa_hosta:pc, gdzie pc to dwuznakowy kod produktu. Jeśli na przykład zostanie podana nazwa instancji Ruby2, nazwą systemu zarządzanego będzie Ruby2:nazwa_hosta:KM, gdzie KM jest dwuznakowym kodem produktu dla agenta dla Ruby.

  2. Po wyświetleniu pytania Edit 'Monitoring Agent for Ruby' settings, wprowadź wartość 1, aby kontynuować.
  3. Po wyświetleniu pytania Fully Qualified Rubies Bin Directory (Pełna ścieżka katalogu binariów Ruby), katalog plików binarnych. Na przykład, jeśli używany jest menedżer Ruby Version Manager (RVM), wpisz /usr/local/rvm/rubies/ruby-2.0.0-p247/bin.
  4. Po wyświetleniu pytania Auto Detect Ruby Applications Flag (Automatyczne wykrywanie opcji aplikacji Ruby), wprowadź wartość Y, aby kontynuować. Agent odbiera dane, które wysyła moduł gromadzący dane agenta.
  5. Gdy zostanie wyświetlone zapytanie o nazwę procesu serwera aplikacji, naciśnij klawisz Enter, aby zaakceptować wartość domyślną ruby lub podaj wartość dla używanego serwera, zgodnie z następującą listą:
    • Dla serwerów WEBrick zaakceptuj wartość domyślną lub podaj wartość ruby. Jeśli środowisko jest instalowane przez Ruby Stack, należy podać wartość .ruby.bin.
    • Dla serwerów Passenger wpisz wartość passenger.
    • Dla serwerów Unicorn wpisz unicorn.
    • Dla serwerów Puma wpisz puma.
    • Dla serwerów Thin, jeśli aplikacje są uruchamiane przez wydanie komendy thin start, zaakceptuj wartość domyślną ruby. Jeśli aplikacje są uruchamiane przez wydanie komendy thin start -d, wpisz wartość thin. Jeśli środowisko Rails zostało zainstalowane przez Ruby Stack i aplikacje są uruchamiane przez wydanie komendy thin start, wpisz wartość .ruby.bin.
  6. Po wyświetleniu pytania o Socket Data Source (Gniazdo źródła danych), naciśnij klawisz Enter, aby zaakceptować wartość domyślną 0 dla tymczasowego portu.
  7. Po wyświetleniu pytania Edit 'Application' settings (Edytuj ustawienia aplikacji), wpisz wartość 5, aby wyjść z ustawień.
  8. Aby uruchomić agenta, wpisz następującą komendę:
    katalog_instalacyjny/bin/ruby-agent.sh start nazwa_instancji

Co dalej

Zainstaluj moduł gromadzący dane, aby agent dla Ruby działał poprawnie i dane mogły być wyświetlane w interfejsie użytkownika programu Cloud APM. Odpowiednie instrukcje zawiera sekcja Instalowanie modułu gromadzącego dane.