PHP izleme uzantısı

Gerekli PHP uzantıları

PHP Tracer 'ı çalıştırmak için JSON uzantısına sahip olmanız gerekir.

Instana izleme uzantısı karşıdan yüklendikten sonra, uzantı zzz-instana.ini dosyasını Additional ini dizininize yerleştirir ya da dosyayı PHP SAPI tarafından kullanılan ini dosyasına ekler.

Daha sonra algılayıcı, izleme uzantısını belleğe yüklemek için PHP ortamınızı yeniden başlatmayı dener. Daha fazla bilgi için bkz. Otomatik yeniden başlatma.

Ayrıca, Plesk kullanıyorsanız, plesk bin php_handler --rereadkomutunu çalıştırmanız gerekir.

PHP uzantısı ayarlarının uyarlanması

PHP izleme uzantısı, zzz-instana.iniiçindeki çoğu izleme senaryosu için aynı varsayılan değerlerle birlikte gönderilir. Ancak, ayarları örnekleme, toplu iş ya da grubuyla bağlama gibi belirli gereksinimleri karşılayacak şekilde ayarlayabilirsiniz.

İzleme uzantısı PHP ortamına yüklendiyse, PHP algılayıcısı zzz-instana.ini üzerine yazmaz. Bu nedenle, uzantıya güvenli bir şekilde ek ayarlar ekleyebilseniz de, konteynerli ayarlarda fazladan ayar eklemek uygunsuz olabilir. Bu tür senaryolarda iyi bir uygulama, fazladan bir dosya eklemek zzz-instana-extras.ini ve bu dosyayı kapsayıcı devreye alımının bir parçası haline getirmektir.

Aşağıdaki ayarlar kullanılabilir:

• instana.socket: Instana PHP Sensor 'un TCP yuvasının adresi. Yuva adresi kuruluş sırasında belirlenir ve varsayılan olarak tcp://127.0.0.1:16816değerine ayarlanır.
• instana.log_level: Günlüğün kaydedileceği düzey: 0 = kapalı, 1 = HATA, 2 = UYARI, 3 = BİLGİ ve 4 = HATA AYIKLAMA. Varsayılan değer 0 'dır (kapalı).
• instana.enable_cli: CLI SAPI için izlemeyi etkinleştirin ya da devre dışı bırakın. 1 = açık. 0 = kapalı. Varsayılan değer 0 'dır (kapalı).
• instana.batch_threshold_us: Kümenin yayıldığı uzunluk ve uzaklık eşiği. Varsayılan değer 10000 'dir.
• instana.backtrace_limit: Kayıtlı çağrı yığınlarının derinliğini denetler. Varsayılan ya da sınırlandırılan değer 25 giriştir.
• instana.span_chunk_size: PHP ' nin aracıya gönderilmeden önce bellekte tutması gereken yayılma sayısı. Bu sayı doğrudan toplu işi etkiler. Örneğin, toplu işi etkili bir şekilde devre dışı bırakan bir grup.
• instana.disable_userland_tracing: Yerel olmayan uzantılar (örneğin, çerçeveler ve diğer PHP kullanıcı ülke kodu) için tüm izlemeyi devre dışı bırakır. Varsayılan değer 0 'dır (kapalı).
• instana.segfault_error_log: PHP ' nin hata oturum açma segfaullerine ilişkin bir geri izleme yakalayın ya da bunlardan kaçının. Varsayılan değer 0 'dır (kapalı).
• instana.disabled_instrumentation: Devre dışı bırakılması gereken özel işlemlerden oluşan bit maskesi. Varsayılan değer 0 'dır (yok).

Kullanılabilir işaretler

Aşağıdaki işaretler kullanılabilir:

• AKışLAR 1
• PHP 2
• PDO 4
• CURL 8
• REDIS 16
• MONGODB 32
• MYSQL 64
• MEMCACHE 128
• Db2 256
• OCI 512
• KABUK 1024
• PECL_HTTP 2048
• ISTEK_ÜSTBILGILERI 4096
• YANıT_BAşLıKLAR 8192
• SOAP 16384
• WORDPRESS 32768
• AMQP 65536 (hem pecl-amqp hem de php-amqp-libiçin geçerlidir)
• ELASTICSEARCH 131072
• KURAL Dışı DURUMLAR 262144
• GüNLüKLER 524288
• COUCHBASE 1048576
• TWIG 2097152
• SYMFONY 4194304
• KOHANA 134217728
• GOOGLE_PUBSUB 268435456

İşaretler ada göre görüntülenmez. Bir özel işlemden geçirmeyi geçersiz kılmak için sayısal değerlerini kullanmanız gerekir.

Bu ayarlarla ilgili yardıma gereksinim duyarsanız, IBM desteğine başvurun.

PHP Tracer 2.0 ' ın ilk kez yapılandırılması

PHP Tracer 2.0 ' ı ilk kez kuruyorsanız, aşağıdaki adımları tamamlayın:

1. Apache ya da NGINX gibi bir web sunucusu kullanıyorsanız, aşağıdaki komutları çalıştırarak bunu durdurun ve PHP FastCGI Process Manager (PHP-FPM) yardımcı programını durdurun:

   systemctl stop apache2
   

   systemctl stop php<version>-fpm
   

   Örneğin:

   systemctl stop php7.4-fpm
   

2. Aşağıdaki yapılandırmaları kullanarak aracı yapılandırma dosyasını /opt/instana/agent/etc/instana/configuration.yaml güncelleyin:

   com.instana.plugin.php:
     tracing:
       enabled: true
       enableHttpTraces: true 
       installExtension: true
       pinextensionVersion: 2.0.1
   

3. Aşağıdaki komutları çalıştırarak web sunucunuza ilişkin yardımcı program işlemini (örneğin, Apache 2 ya da NGINX) başlatın:

   systemctl daemon-reload
   

   systemctl start apache2
   

   systemctl start php<version>-fpm
   

4. Instana aracısını başlatın ya da yeniden başlatın ve aşağıdaki komutları kullanarak durumunu denetleyin:

   systemctl start instana-agent
   

   systemctl restart instana-agent
   

   systemctl status instana-agent
   

5. Aşağıdaki ini ayarlarının zzz-instana.ini dosyasında doğru değerlere sahip olup olmadığını doğrulayın. Bu YönOrtama özgü ayarları listelemek için aşağıdaki komutu kullanın:

   php-fpm<version> -i |grep instana
   

   • instana.use_agent_endpoint: Bu değer 1 olarak ayarlanmalıdır.

   • instana.agent_endpoint: Bu değer http://127.0.0.1:42699olarak ayarlanmalıdır.

   • instana.pid_in_root_namespace: mod_php 'yi Apacheile kullanıyorsanız, bu değer Apache işlem tanıtıcısıyla eşleşmelidir. FPM Apachearacılığıyla yapılandırıldıysa, bu değer PHP-FPM ana işlem tanıtıcısı olmalıdır. Değer eşleşmiyorsa, instana.pid_in_root_namespace dosyasını düzenleyin ve aşağıdaki komutu kullanarak FPM ya da Apache yardımcı programını yeniden yükleyin:

     systemctl reload php<version>-fpm
     

     systemctl reload apache2
     

   NOT: Aşağıdaki komutları kullanarak işlem tanıtıcısını alabilirsiniz:

   ps ax | grep fpm
   

   ps -ax| grep apache2
   

6. Instana kullanıcı arabirimindeki PHP çalıştırma zamanı gösterge panosunda, PHP uzantı sürümünün ve zzz-instana.ini sürümünün var olduğunu doğrulayın. Bu bilgilerin kullanıcı arabiriminde yansıtımesi biraz zaman alabilir. FPM ' yi yeniden başlatıyorsanız, işlem tanıtıcısının ana işlem tanıtıcısıyla eşleştiğinden emin olun.

PHP Tracer 'a yükseltme 2.0

PHP Tracer 1.0kullanıyorsanız, PHP Tracer 2.0:

1. Instana aracısını ve PHP-FPM ve Apache yardımcı programını durdurmak için aşağıdaki komutları çalıştırın:

   systemctl stop instana-agent
   

   systemctl stop apache2
   

   systemctl stop php<version>-fpm
   

2. İsteğe bağlı: php extension_dir extension_dir ve php ini scan --with-config-file-scan-dir dizinlerinden instana.so ve zzz-instana.ini yapılandırma dosyalarını yedekleyin.

3. instana.so ikili dosyasını ve zzz-instana.ini dosyasını php extension_dir extension_dir ve php ini scan --with-config-file-scan-dir dizinlerinden kaldırın.

4. PHP Tracer 2.0'ı etkinleştirmek için, PHP Tracer 2.0 ' ın ilk kez yapılandırılması kısmında açıklanan adımları izleyin.

PHP izleme algılayıcısını devre dışı bırakma

PHP İzleme algılayıcısını devre dışı bırakmak için aşağıdaki adımları tamamlayın:

1. <agent_install_dir>/etc/instana/configuration.yml dosyasını bir metin düzenleyicisiyle açın. Aşağıdaki giriş görüntülenir:

com.instana.plugin.php:
  tracing:
    enabled: true

2. enabled: true değerini enabled: falseolarak değiştirin. İzleme varsayılan olarak etkinleştirildiğinden, false açıklama ekleme işlemi izlemeyi devre dışı bırakmaz.

Diğer bir seçenek olarak, PHP izleme uzantısının kuruluşunu devre dışı bırakmak, ancak izlemeler için algılayıcıyı açık tutmak için installExtension: false ayarını da ayarlayabilirsiniz.

Değişiklikleri uygulamak için aracıyı yeniden başlatmanız gerekir.

Not: Algılayıcının devre dışı bırakılması, izleme uzantısını devre dışı bırakmaz.

PHP izleme uzantısının geçersiz kılınması

PHP algılayıcısı uzantıyı taktığında, PHP kuruluşunuz için uzantıyı da etkinleştirdi. Uzantının etkinleştirilmesi, PHP algılayıcısının zzz-instana.ini dosyasını Additional Ini dosyalar klasörünüze yerleştirdiği ya da doğrudan php.inidosyanıza etkinleştirdiği anlamına gelir.

Nerede etkinleştirildiğini öğrenmek için, izlemeyi etkinleştirdiğiniz PHP ikili dosyasını çalıştırın. Aşağıdaki örnek, PHP-FPM için PHP ikili dosyasını göstermektedir:

    $> php-fpm7.0 -i | egrep "^(Scan|Loaded)"
    Loaded Configuration File => /etc/php/7.0/fpm/php.ini
    Scan this dir for additional .ini files => /etc/php/7.0/fpm/conf.d

Bu örnekte, zzz-instana.ini dosyası /etc/php/7.0/fpm/conf.ddizininde bulunur. Kullanılabilir bir Additional Ini dosya klasörü yoksa ya da zzz-instana.ini dosyası o konumda yoksa, bunun yerine php.ini dosyanızı denetleyin. Bu örnekte dosya /etc/php/7.0/fpm/php.ini' dedir.

Not: Mod_php içeren Apache için, <?php phpinfo(); içerikli bir PHP dosyasını Apache üzerinde web üzerinden erişilebilir bir konuma koyun ve aynı bilgiler için bir tarayıcıda açın.

PHP izleme uzantısını geçersiz kılmak için aşağıdaki adımları izleyin:

1. Uygun ini dosyasını bir düzenleyicide açın ve extension=/path/to/instana.so satırında noktalı virgül (;) önekini ekleyin. Satırın dışına noktalı virgül açıklamaları ekleniyor.

   ;extension=/path/to/instana.so

   Diğer bir seçenek olarak, extension=/path/to/instana.so çizgisini tümüyle kaldırın. Not: Uzantının daha sonraki bir noktada etkinleştirilmesini istiyorsanız kaldırmayın.

2. zzz-instana.ini kütüğüne sahipseniz, kütüğü aşağıdaki gibi tümüyle kaldırabilirsiniz:

   $> sudo rm /etc/php/7.0/fpm/conf.d/zzz-instana.ini
   

   Önemli: php.ini dosyanızın tamamını kaldırmayın.

3. Önceden çatallı çalışanlar kullanıyorsanız, PHP ana sürecini şimdi yeniden başlatmanız gerekir. Tersi durumda, uzantı bellekte etkin kalır.

Not: Uzantının devre dışı bırakılması, uzantıyı sisteminizden kaldırmaz.

PHP izleme uzantısının kaldırılması

PHP, bir uzantı bulamadığında başlatma hatalarını günlüğe kaydeder; bu nedenle, uzantıyı kaldırmadan önce de devre dışı bırakmanız gerekir. Daha fazla bilgi için PHP izleme uzantısını devre dışı bırakmabaşlıklı konuya bakın.

PHP algılayıcısı, Instana PHP izleme uzantısını php.iniiçindeki extension_dir ayarında belirtilen dizine yerleştirir. Ayarı öğrenmek için izlemeyi etkinleştirdiğiniz PHP ikili dosyasını çalıştırın. Aşağıdaki örnek, PHP-FPM için PHP ikili dosyasını göstermektedir:

$> php-fpm7.0 -i | egrep ^extension_dir
extension_dir => /usr/lib/php/20151012 => /usr/lib/php/ext

Not: Mod_php içeren Apache için, <?php phpinfo(); içerikli bir PHP dosyasını Apache üzerinde web üzerinden erişilebilir bir konuma koyun ve aynı bilgiler için bir tarayıcıda açın.

PHP algılayıcısı yalnızca ilk değeri kullanır; bu nedenle, örnekte at/usr/lib/php/20151012uzantısını bulabilirsiniz. Uzantının yolu php.ini ya da instana.iniiçinde de verilir.

Uzantıyı kaldırmak için aşağıdaki komutu çalıştırın:

$> sudo rm /usr/lib/php/20151012/instana.so

Önceden çatallı çalışanlar kullanıyorsanız ve uzantıyı devre dışı bıraktığınızda PHP ana sürecinizi yeniden başlatmadıysanız, değişikliklerin yürürlüğe girmesi için şimdi yeniden başlatmanız gerekir.