Konfigurowanie monitorowania PHP

Agent monitorowania dla PHP musi zostać skonfigurowany, aby mógł gromadzić dane z monitorowanych aplikacji PHP.

Zanim rozpoczniesz

Upewnij się, że zainstalowano pakiet php-process. Jeśli jest używana komenda yum install do instalacji języka PHP, należy uruchomić komendę yum install php-process, aby zainstalować pakiet php-process.
Przed skonfigurowaniem agenta należy upewnić się, że został uruchomiony serwer Apache HTTPD.
Sprawdź, czy w pliku konfiguracyjnym serwera Apache HTTP Server (httpd.conf) opcje mod_status i ExtendedStatus On są włączone. Na przykład:
```
ExtendedStatus On
<Location /server-status>
		SetHandler server-status
		Order deny,allow
		Allow from all
		Allow from 127.0.0.1
</Location>
```
W podanym przykładzie adres http://127.0.0.1/server-status musi działać, aby agent mógł pracować poprawnie.
Uwaga: W systemie Linux musi być zainstalowana przeglądarka Lynx lub Links, aby agent mógł pobierać dane monitorowania.

Upewnij się, że komenda apachectl status działa prawidłowo w monitorowanym serwerze Apache bez zmian kodu w komendzie apachectl. Aby komenda apachectl status działała poprawnie, musi być zainstalowana przeglądarka Lynx.

O tym zadaniu

Aby uniknąć problemów z uprawnieniami podczas konfigurowania agenta, należy użyć tego samego użytkownika root lub innego niż root, który został użyty do zainstalowania agenta. Jeśli agent został zainstalowany przez wybranego użytkownika i chcesz skonfigurować agenta z użyciem innego użytkownika, patrz sekcja Konfigurowanie agentów przez użytkowników innych niż root. Jeśli agent został zainstalowany i skonfigurowany przez określonego użytkownika i chcesz skonfigurować agenta z użyciem innego użytkownika, patrz sekcja Uruchamianie agentów jako użytkownik inny niż root.

Agent dla PHP jest agentem obsługującym wiele instancji. Operację utworzenia pierwszej instancji i uruchomienia agenta należy wykonać samodzielnie. Nazwa systemu zarządzanego zawiera podaną nazwę instancji, na przykład: nazwa_instancji:nazwa_hosta:pc, gdzie pc to dwuznakowy kod produktu. Długość nazwy systemu zarządzanego jest ograniczona do 32 znaków. Maksymalna długość podanej nazwy instancji nie może przekraczać 28 znaków minus długość nazwy hosta. Jeśli na przykład zostanie określona nazwa instancji PHP2, nazwą systemu zarządzanego jest PHP2:nazwa_hosta:PJ.

Ważne: Jeśli zostanie podana długa nazwa instancji, nazwa systemu zarządzanego zostanie obcięta i kod agenta nie zostanie poprawnie wyświetlony.

Procedura

Jeśli w używanym środowisku są stosowane ustawienia domyślne, konfigurując agenta, można użyć domyślnej ścieżki wykonywalnych plików binarnych, domyślnej ścieżki pliku php.ini oraz domyślnego portu:
1. Wpisz:
  katalog_instalacyjny/bin/php-agent.sh config nazwa_instancji katalog_instalacyjny/samples/php_silent_config.txt
  Gdzie nazwa_instancji to nazwa, która ma zostać nadana instancji, a katalog_instalacyjny to katalog instalacyjny agenta dla PHP. Domyślny katalog instalacyjny to: /opt/ibm/apm/agent.
2. Aby uruchomić agenta, wpisz komendę:
  katalog_instalacyjny/bin/php-agent.sh start nazwa_instancji
Aby skonfigurować agenta, edytując plik odpowiedzi konfiguracji cichej oraz uruchamiając skrypt bez interakcji z użytkownikiem, wykonaj następujące kroki:
1. Otwórz w edytorze tekstu plik katalog_instalacyjny/samples/php_silent_config.txt.
2. W parametrze Location of PHP execution binary (Położenie wykonywalnego pliku binarnego PHP) możesz podać katalog, w którym znajduje się plik wykonywalny PHP. Domyślnym położeniem jest /usr/local/bin.
3. W parametrze Location of PHP INI file (Położenie pliku INI PHP) możesz podać katalog, w którym znajduje się plik php.ini. Domyślnym położeniem jest /etc.
4. W parametrze Web server port (Port serwera WWW) możesz podać numer portu serwera WWW, na którym działa program WordPress. Wartością domyślną jest 80.
5. W parametrze Application DocumentRoot (Element główny dokumentu aplikacji) możesz podać element główny dokumentu (DocumentRoot) aplikacji PHP WordPress. Użyj dwukropka do oddzielenia wielu rekordów. Aby umożliwić agentowi automatyczne znalezienie wszystkich rekordów, użyj wartości domyślnej ALL (Wszystkie).
6. Zapisz i zamknij plik php_silent_config.txt, a następnie wpisz komendę:
  katalog_instalacyjny/bin/php-agent.sh config nazwa_instancji katalog_instalacyjny/samples/php_silent_config.txt
  Gdzie nazwa_instancji to nazwa, która ma zostać nadana instancji, a katalog_instalacyjny to katalog instalacyjny agenta dla PHP. Domyślny katalog instalacyjny to: /opt/ibm/apm/agent.
7. Aby uruchomić agenta, wpisz komendę:
  katalog_instalacyjny/bin/php-agent.sh start nazwa_instancji
Aby skonfigurować agenta przez uruchomienie skryptu i udzielenie odpowiedzi na pytania, wykonaj następujące kroki:
1. Wpisz:
  katalog_instalacyjny/bin/php-agent.sh config nazwa_instancji
  Gdzie nazwa_instancji to nazwa, która ma zostać nadana instancji, a katalog_instalacyjny to katalog instalacyjny agenta dla PHP.
2. Gdy zostanie wyświetlone zapytanie Edit Monitoring Agent for PHP settings (Edytuj ustawienia agenta monitorowania PHP), wprowadź wartość 1, aby kontynuować.
3. Gdy zostanie wyświetlone zapytanie Location of PHP execution binary (Położenie wykonywalnego pliku binarnego PHP) naciśnij klawisz Enter, aby zaakceptować położenie domyślne, lub podaj położenie.
4. Gdy zostanie wyświetlone zapytanie Location of PHP INI file (Położenie pliku INI PHP) naciśnij klawisz Enter, aby zaakceptować położenie domyślne, lub podaj położenie.
5. Gdy zostanie wyświetlone zapytanie Web server port (Port serwera WWW), naciśnij klawisz Enter, aby zaakceptować port domyślny, lub podaj inny numer portu.
6. Gdy zostanie wyświetlone zapytanie Application DocumentRoot (Element główny dokumentu aplikacji), naciśnij klawisz Enter, aby zaakceptować wartość domyślną, lub podaj element główny dokumentu (DocumentRoot) aplikacji PHP WordPress. Do oddzielenia wielu rekordów możesz użyć dwukropka.
7. Aby uruchomić agenta, wpisz komendę:
  katalog_instalacyjny/bin/php-agent.sh start nazwa_instancji

Wyniki

Agent sprawdza tylko wydajność żądań PHP w aplikacjach WordPress. Ładowania CSS i JS nie są sprawdzane. Agent nie identyfikuje adresów URL za pomocą argumentów URL.

Co dalej

Można sprawdzić dane agenta dla PHP wyświetlane w konsoli Cloud APM.

Należy upewnić się, że aktywowana została wtyczka WordPress dla agenta. W tym celu wykonaj następujące kroki:

W przeglądarce WWW wpisz następujący adres URL http://nazwa_hosta:port/wp-admin/.
Otwórz stronę administracyjną, przechodząc do opcji Wtyczki > Zainstalowane wtyczki.
Sprawdź, czy wtyczka agenta dla PHP jest aktywowana. Wtyczka agenta dla PHP jest wymieniona jako WordPress Agent. Zwykle wtyczka jest już aktywowana. Jeśli jeszcze nie jest aktywowana, kliknij opcję Aktywuj.