İzleme

Bu belgede, Apigee Edge for Private Cloud'un şirket içi dağıtımı tarafından desteklenen bileşenlerin izleme teknikleri açıklanmaktadır.

Genel Bakış

Edge, hizmetlerle ilgili ayrıntıları öğrenmenin ve durumlarını kontrol etmenin çeşitli yollarını destekler. Aşağıdaki tabloda, uygun her hizmette gerçekleştirebileceğiniz kontrol türleri listelenmiştir:

İzleme bağlantı noktaları ve yapılandırma dosyaları

Her bileşen, farklı bağlantı noktalarında Java Management Extensions (JMX) ve Management API izleme çağrılarını destekler. Aşağıdaki tabloda, her sunucu türü için JMX ve Management API bağlantı noktaları ve yapılandırma dosyası konumları listelenmiştir:

Bileşenleri izlemek için JMX'i kullanma

Aşağıdaki bölümlerde, Edge bileşenlerini izlemek için JMX'in nasıl kullanılacağı açıklanmaktadır.

JMX'i etkinleştirme

JMX'i kimlik doğrulama veya SSL tabanlı iletişim olmadan etkinleştirmek için aşağıdaki adımları uygulayın. Not: Üretim sistemlerinde güvenlik için hem şifrelenmiş kimlik doğrulama hem de SSL etkinleştirilmelidir.

1. Uygun yapılandırma dosyasını düzenleyin ( Yapılandırma dosyası referansı bölümüne bakın). Yapılandırma dosyası yoksa oluşturun.

   conf_system_jmxremote_enable=true

2. Yapılandırma dosyasını kaydedin ve sahibinin apigee:apigee olduğundan emin olun.
3. Uygun Edge bileşenini yeniden başlatın.

   apigee-service edge-management-server restart

JMX'i devre dışı bırakmak için conf_system_jmxremote_enable özelliğini kaldırın veya değerini false olarak değiştirin. Ardından, ilgili Edge bileşenini yeniden başlatın.

JMX'te kimlik doğrulama

Edge for Private Cloud, dosyalarda depolanan bilgileri kullanarak şifre tabanlı kimlik doğrulamayı destekler. Şifreleri daha fazla güvenlik için karma olarak saklayabilirsiniz.

1. Bir edge-* bileşeninde JMX kimlik doğrulamasını etkinleştirmek için uygun yapılandırma dosyasını düzenleyin ( Yapılandırma dosyası referansı bölümüne bakın). Yapılandırma dosyası yoksa oluşturun:

   conf_system_jmxremote_enable=true
   conf_system_jmxremote_authenticate=true
   conf_system_jmxremote_encrypted_auth=true
   conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
   conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password

   Yapılandırma dosyasını kaydedin ve sahibinin apigee:apigee olduğundan emin olun.
2. Şifrenin SHA256 karma değerini oluşturun:

   echo -n '' | openssl dgst -sha256

3. JMX kullanıcı kimlik bilgilerini içeren bir jmxremote.password dosyası oluşturun:
   1. Aşağıdaki dosyaları $JAVA_HOME dizininizden /opt/apigee/customer/application/<component>/ dizinine kopyalayın:

      cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/management-server/jmxremote.password

   2. Dosyayı düzenleyin ve aşağıdaki söz dizimini kullanarak JMX kullanıcı adınızı ve şifrenizi ekleyin:

      USERNAME <HASH-PASSWORD>

   3. Dosyanın sahibinin apigee olduğundan ve dosya modunun 400 olduğundan emin olun:

      chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
      chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.password

4. JMX kullanıcı izinleriyle bir jmxremote.access dosyası oluşturun:
   1. Aşağıdaki dosyaları $JAVA_HOME dizininizden /opt/apigee/customer/application/<component>/ dizinine kopyalayın.

      
      cp ${JAVA_HOME}/lib/management/jmxremote.access$APIGEE_ROOT/customer/application/management-server/jmxremote.password/jmxremote.access

   2. Dosyayı düzenleyin ve JMX kullanıcı adınızı, ardından bir izin (READONLY/READWRITE) ekleyin.

      USERNAME READONLY

   3. Dosyanın sahibinin apigee olduğundan ve dosya modunun 400 olduğundan emin olun:

      chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
      
      chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.access

5. Uygun Edge bileşenini yeniden başlatın:

   apigee-service edge-management-server restart

JMX kimlik doğrulamasını devre dışı bırakmak için conf_system_jmxremote_authenticate özelliğini kaldırın veya değeri false olarak değiştirin ve ilgili Edge bileşenini yeniden başlatın.

JMX'te SSL

Bir edge-* bileşeninde SSL tabanlı JMX'i etkinleştirmek için:

1. Uygun yapılandırma dosyasını düzenleyin ( Yapılandırma dosyası referansı bölümüne bakın). Yapılandırma dosyası yoksa oluşturun:

   conf_system_jmxremote_enable=true
   conf_system_jmxremote_ssl=true
   conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
   conf_system_javax_net_ssl_keystorepassword=<keystore-password>

   Yapılandırma dosyasını kaydedin ve sahibinin apigee:apigee olduğundan emin olun.
2. Sunucu anahtarını içeren bir anahtar deposu hazırlayın ve yukarıdaki conf_system_javax_net_ssl_keystore yapılandırmasında belirtilen yola yerleştirin. Anahtar deposu dosyasının apigee:apigee tarafından okunabilir olduğundan emin olun.
3. Uygun Edge bileşenini yeniden başlatın:

   apigee-service edge-management-server restart

SSL tabanlı JMX'i devre dışı bırakmak için conf_system_jmxremote_ssl özelliğini kaldırın veya değeri false olarak değiştirin. İlgili Edge bileşenini yeniden başlatın.

Jconsole üzerinden izleme

jconsole aracılığıyla izleme talimatları, https://docs.apigee.com/private-cloud/v4.50.00/how-monitor#jconsole adresinde açıklandığı şekilde kalır.

JConsole ile izleme

Durum kontrolü ve işlem istatistiklerini yönetmek ve izlemek için JConsole'u (JMX uyumlu bir araç) kullanın. JConsole ile sunucularınız tarafından sunulan JMX istatistiklerini kullanabilir ve bunları grafik arayüzde görüntüleyebilirsiniz. Daha fazla bilgi için JConsole'u kullanma başlıklı makaleyi inceleyin.

JMX için SSL etkinleştirilmişse JConsole'u güvenilir depo ve güvenilir depo şifresiyle başlatmanız gerekir. JConsole'u kullanma başlıklı makaleyi inceleyin.

JConsole, JMX aracılığıyla sunulan JMX özelliklerini (MBean'ler) izlemek için aşağıdaki hizmet URL'sini kullanır:

service:jmx:rmi:///jndi/rmi://IP_address:port_number/jmxrmi

Burada:

• IP_address, izlemek istediğiniz sunucunun IP adresidir.
• port_number, izlemek istediğiniz sunucunun JMX bağlantı noktası numarasıdır.

Örneğin, Yönetim Sunucusu'nu izlemek için aşağıdaki gibi bir komut verin (sunucunun IP adresinin 216.3.128.12 olduğunu varsayalım):

service:jmx:rmi:///jndi/rmi://216.3.128.12:1099/jmxrmi

Bu örnekte, Yönetim Sunucusu JMX bağlantı noktası olan 1099 numaralı bağlantı noktasının belirtildiğini unutmayın. Diğer bağlantı noktaları için JMX ve Management API izleme bağlantı noktaları başlıklı makaleyi inceleyin.

Aşağıdaki tabloda genel JMX istatistikleri gösterilmektedir:

Yapılandırma dosyası referansı

Aşağıdaki bölümlerde, JMX ile ilgili yapılandırmalar için Edge bileşeni yapılandırma dosyalarında yapmanız gerekebilecek değişiklikler açıklanmaktadır. Daha fazla bilgi için Bağlantı noktalarını ve yapılandırma dosyalarını izleme başlıklı makaleyi inceleyin.

Uygun bileşenin yapılandırma dosyasına eklenecek JMX yapılandırması

• Edge bileşeninde JMX aracısını etkinleştirin. Varsayılan olarak "False" (Yanlış) değerine ayarlanır.

  conf_system_jmxremote_enable=true

Şifre tabanlı kimlik doğrulama yapılandırmaları

• Şifre tabanlı kimlik doğrulamayı etkinleştirin. Varsayılan olarak "False" (Yanlış) değerine ayarlanır.

  conf_system_jmxremote_authenticate=true

• Dosyaya erişim yolu. Yalnızca Apigee kullanıcısına ait olmalı ve yalnızca Apigee kullanıcısı tarafından okunabilmelidir.

  conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access

• Şifre dosyasının yolu. Yalnızca Apigee kullanıcısına ait olmalı ve yalnızca Apigee kullanıcısı tarafından okunabilmelidir.

  conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password

• Şifrenin şifrelenmiş biçimde depolanmasını etkinleştirin. Varsayılan olarak "False" (Yanlış) değerine ayarlanır.

  conf_system_jmxremote_encrypted_auth=true

SSL tabanlı JMX için yapılandırmalar

• JMX iletişimi için SSL'yi etkinleştirin. Varsayılan olarak "False" (Yanlış) değerine ayarlanır.

  conf_system_jmxremote_ssl=true

• Anahtar deposu yolu. Yalnızca Apigee kullanıcısına ait olmalı ve yalnızca Apigee kullanıcısı tarafından okunabilmelidir.

  conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore

• Anahtar deposu şifresi:

  conf_system_javax_net_ssl_keystorepassword=changeme

İsteğe bağlı JMX yapılandırmaları

Listelenen değerler varsayılan değerlerdir ve değiştirilebilir.

• JMX bağlantı noktası. Varsayılan değerler aşağıdaki tabloda listelenmiştir.

  conf_system_jmxremote_port=

• JMX RMI bağlantı noktası. Varsayılan olarak Java işlemi rastgele bir bağlantı noktası seçer.

  conf_system_jmxremote_rmi_port=

• Uzak taslaklar için ana makine adı. Localhost'un varsayılan IP adresi.

  conf_system_java_rmi_server_hostname=

• JMX kayıt defterini SSL ile koruyun. Varsayılan değer: false. Yalnızca SSL etkinse geçerlidir.

  conf_system_jmxremote_registry_ssl=false

Management API ile izleme

Edge, sunucularınızda hizmet kontrolleri yapmanın yanı sıra kullanıcılarınızı, kuruluşlarınızı ve dağıtımlarınızı kontrol etmek için kullanabileceğiniz çeşitli API'ler içerir. Bu bölümde bu API'ler açıklanmaktadır.

Hizmet kontrolleri yapma

Management API, hizmetlerinizle ilgili sorunları izlemek ve teşhis etmek için çeşitli uç noktalar sağlar. Bu uç noktalar şunlardır:

<ServerField>
  <Up>true</Up>
</ServerField>

curl: Failed connect to localhost:port_number; Connection refused

Bu uç noktaları kullanmak için aşağıdaki söz dizimini kullanan komutlarla curl gibi bir yardımcı programı çağırın:

curl http://host:port_number/v1/servers/self/up -H "Accept: [application/json|application/xml]"
curl http://host:port_number/v1/servers/self -u username:password -H "Accept: [application/json|application/xml]"

Burada:

• host, kontrol etmek istediğiniz sunucunun IP adresidir. Sunucuya giriş yaptıysanız "localhost"u kullanabilirsiniz. Giriş yapmadıysanız sunucunun IP adresini, kullanıcı adını ve şifresini belirtin.
• port_number, kontrol etmek istediğiniz sunucunun Management API bağlantı noktasıdır. Bu, her bileşen türü için farklı bir bağlantı noktasıdır. Örneğin, Yönetim Sunucusu'nun Management API bağlantı noktası 8080'dir. Kullanılacak Management API bağlantı noktası numaralarının listesi için JMX ve Management API izleme bağlantı noktaları başlıklı makaleyi inceleyin.

Yanıtın biçimini değiştirmek için Accept başlığını "application/json" veya "application/xml" olarak belirtebilirsiniz.

Aşağıdaki örnekte, localhost'taki (bağlantı noktası 8081) yönlendiricinin durumu alınmaktadır:

curl http://localhost:8081/v1/servers/self/up -H "Accept: application/xml"

Aşağıdaki örnekte, 216.3.128.12 (bağlantı noktası 8082) adresindeki Mesaj İşleyici hakkında bilgi alınmaktadır:

curl http://216.3.128.12:8082/v1/servers/self -u sysAdminEmail:password
  -H "Accept: application/xml"

Kullanıcı, kuruluş ve dağıtım durumunu izleme

Aşağıdaki komutları vererek Yönetim Sunucuları ve Mesaj İşlemciler'deki proxy'lerinizin kullanıcı, kuruluş ve dağıtım durumunu izlemek için Management API'yi kullanabilirsiniz:

curl http://host:port_number/v1/users -u sysAdminEmail:password
curl http://host:port_number/v1/organizations -u sysAdminEmail:password
curl http://host:port_number/v1/organizations/orgname/deployments -u sysAdminEmail:password

Burada port_number, Yönetim Sunucusu için 8080 veya Mesaj İşleyici için 8082'dir.

Bu çağrı, sistem yönetimi kullanıcı adınız ve şifrenizle kimlik doğrulaması yapmanızı gerektirir.

Sunucu, tüm çağrılar için "dağıtıldı" durumunu döndürmelidir. Bu yöntemler işe yaramazsa aşağıdakileri yapın:

1. Hata olup olmadığını görmek için sunucu günlüklerini kontrol edin. Günlükler şu konumda bulunur:
   • Yönetim Sunucusu: opt/apigee/var/log/edge-management-server
   • Mesaj İşlemcisi: opt/apigee/var/log/edge-message-processor
2. Düzgün çalışıp çalışmadığını kontrol etmek için sunucuya bir çağrı yapın.
3. Sunucuyu ELB'den kaldırın ve ardından yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service service_name restart

   service_name:

   • edge-management-server
   • edge-message-processor

apigee-service komutuyla durumu kontrol edin.

Hizmeti çalıştıran sunucuya giriş yaptığınızda apigee-service komutunu kullanarak Edge hizmetlerinizle ilgili sorunları giderebilirsiniz.

apigee-service ile bir hizmetin durumunu kontrol etmek için:

1. Sunucuya giriş yapın ve aşağıdaki komutu çalıştırın:

   /opt/apigee/apigee-service/bin/apigee-service service_name status

   service_name, aşağıdakilerden biridir:

   • Yönetim Sunucusu: edge-management-server
   • Mesaj İşlemcisi: edge-message-processor
   • Postgres: edge-postgres-server
   • Qpid: edge-qpid-server
   • Yönlendirici: edge-router

   Örneğin:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor status

2. Hizmet çalışmıyorsa hizmeti başlatın:

   /opt/apigee/apigee-service/bin/apigee-service service_name start

3. Hizmeti yeniden başlattıktan sonra, daha önce kullandığınız apigee-service status komutunu veya Management API ile izleme bölümünde açıklanan Management API'yi kullanarak hizmetin çalışıp çalışmadığını kontrol edin.

   Örneğin:

   curl -v http://localhost:port_number/v1/servers/self/up

   port_number, hizmetin Management API bağlantı noktasıdır.

   Bu örnekte, sunucuya giriş yaptığınız ve ana makine adı olarak "localhost"u kullanabileceğiniz varsayılmaktadır. Management API ile durumu uzaktan kontrol etmek için sunucunun IP adresini belirtmeniz ve API çağrınıza sistem yöneticisi kullanıcı adını ve şifresini eklemeniz gerekir.

Postgres izleme

Postgres, durumunu kontrol etmek için kullanabileceğiniz çeşitli yardımcı programları destekler. Bu yardımcı programlar sonraki bölümlerde açıklanmıştır.

Postgres'te kuruluşları ve ortamları kontrol etme

Postgres sunucusuna eklenen kuruluş ve ortam adlarını kontrol etmek için aşağıdaki curl komutunu kullanabilirsiniz:

curl -v http://postgres_IP:8084/v1/servers/self/organizations

Sistem, kuruluş ve ortam adını göstermelidir.

Analiz durumunu doğrulama

Aşağıdaki curl komutunu kullanarak Postgres ve Qpid analiz sunucularının durumunu doğrulayabilirsiniz:

curl -u userEmail:password http://host:port_number/v1/organizations/orgname/environments/envname/provisioning/axstatus

Sistem, aşağıdaki örnekte gösterildiği gibi tüm analiz sunucuları için başarı durumu göstermelidir:

{
  "environments" : [ {
    "components" : [ {
      "message" : "success at Thu Feb 28 10:27:38 CET 2013",
      "name" : "pg",
      "status" : "SUCCESS",
      "uuid" : "[c678d16c-7990-4a5a-ae19-a99f925fcb93]"
     }, {
      "message" : "success at Thu Feb 28 10:29:03 CET 2013",
      "name" : "qs",
      "status" : "SUCCESS",
      "uuid" : "[ee9f0db7-a9d3-4d21-96c5-1a15b0bf0adf]"
     } ],
    "message" : "",
    "name" : "prod"
   } ],
  "organization" : "acme",
  "status" : "SUCCESS"
}

PostgreSQL veritabanı

Bu bölümde, özellikle Postgres veritabanını izlemek için kullanabileceğiniz teknikler açıklanmaktadır.

check_postgres.pl komut dosyasını kullanma

PostgreSQL veritabanını izlemek için standart bir izleme komut dosyası olan check_postgres.pl kullanabilirsiniz. Daha fazla bilgi için http://bucardo.org/wiki/Check_postgres adresini ziyaret edin.

Senaryoyu çalıştırmadan önce:

1. check_postgres.pl komut dosyasını her Postgres düğümüne yüklemeniz gerekir.
2. Yüksek çözünürlüklü alarm, uyku, gettimeofday ve aralık zamanlayıcıları uygulayan bir Perl modülü olan perl-Time-HiRes.x86_64 modülünü yüklediğinizden emin olun. Örneğin, aşağıdaki komutu kullanarak yükleyebilirsiniz:
   

   yum install perl-Time-HiRes.x86_64

3. CentOS 7: CentOS 7 sürümünde check_postgres.pl komutunu kullanmadan önce perl-Data-Dumper.x86_64 RPM'yi yükleyin.

check_postgres.pl çıkışı

check_postgres.pl kullanan API çağrılarının varsayılan çıkışı Nagios ile uyumludur. Komut dosyasını yükledikten sonra aşağıdaki kontrolleri yapın:

1. Veritabanı boyutunu kontrol edin:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -include=apigee -action database_size --warning='800 GB' --critical='900 GB'

2. Veritabanına gelen bağlantı sayısını kontrol eder ve izin verilen maksimum bağlantı sayısıyla karşılaştırır:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends

3. Veritabanının çalışır durumda ve kullanılabilir olup olmadığını kontrol edin:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action connection

4. Disk alanını kontrol edin:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action disk_space --warning='80%' --critical='90%'

5. Postgres düğümüne eklenen kuruluş ve ortam sayısını kontrol edin:

   check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action=custom_query --query="select count(*) as result from pg_tables where schemaname='analytics' and tablename like '%fact'" --warning='80' --critical='90' --valtype=integer

Veritabanı kontrollerini çalıştırma

PostgreSQL veritabanında doğru tabloların oluşturulduğunu doğrulayabilirsiniz. Aşağıdaki komutu kullanarak PostgreSQL veritabanına giriş yapın:

psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee

Ardından şu komutu çalıştırın:

\d analytics."org.env.fact"

Postgres işleminin durumunu kontrol etme

Aşağıdaki curl komutunu çağırarak Postgres makinesinde API kontrolleri yapabilirsiniz:

curl -v http://postgres_IP:8084/v1/servers/self/health

Bu komut, postgres işlemi etkin olduğunda ACTIVE durumunu döndürür. Postgres işlemi çalışmıyorsa INACTIVE durumunu döndürür.

Postgres kaynakları

Postgres hizmetini izleme hakkında daha fazla bilgi için aşağıdakileri inceleyin:

• http://www.postgresql.org/docs/9.0/static/monitoring.html
• http://www.postgresql.org/docs/9.0/static/diskusage.html
• http://bucardo.org/check_postgres/check_postgres.pl.html

Apache Cassandra

JMX, Cassandra için varsayılan olarak etkindir ve Cassandra'ya uzaktan JMX erişimi için şifre gerekmez.

Cassandra için JMX kimlik doğrulamasını etkinleştirme

Cassandra için JMX kimlik doğrulamasını etkinleştirebilirsiniz. Bunu yaptıktan sonra, nodetool yardımcı programına yapılan tüm çağrılara bir kullanıcı adı ve şifre iletmeniz gerekir.

Cassandra için JMX kimlik doğrulamasını etkinleştirmek üzere:

1. cassandra.properties dosyasını oluşturun ve düzenleyin:
   1. /opt/apigee/customer/application/cassandra.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
   2. Dosyaya aşağıdakileri ekleyin:

      conf_cassandra_env_com.sun.management.jmxremote.authenticate=true
      conf_cassandra_env_com.sun.management.jmxremote.password.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.password
      conf_cassandra_env_com.sun.management.jmxremote.access.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.access

   3. cassandra.properties dosyasını kaydedin.
   4. Aşağıdaki örnekte gösterildiği gibi, dosyanın sahibini apigee:apigee olarak değiştirin:

      chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

   Jetonları ayarlamak için özellik dosyalarını kullanma hakkında daha fazla bilgi edinmek istiyorsanız Edge'i yapılandırma başlıklı makaleyi inceleyin.

2. jmx_auth.sh oluşturma ve düzenleme:
   1. Aşağıdaki konumda dosya yoksa oluşturun:

      /opt/apigee/customer/application/jmx_auth.sh

   2. Dosyaya aşağıdaki özellikleri ekleyin:

      export CASS_JMX_USERNAME=JMX_USERNAME
      export CASS_JMX_PASSWORD=JMX_PASSWORD

   3. jmx_auth.sh dosyasını kaydedin.
   4. Dosyayı kaynak olarak kullanın:

      source /opt/apigee/customer/application/jmx_auth.sh

3. jmxremote.password dosyasını kopyalayıp düzenleyin:
   1. Aşağıdaki dosyayı $JAVA_HOME dizininizden /opt/apigee/customer/application/apigee-cassandra/ dizinine kopyalayın:

      cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password

   2. jmxremote.password dosyasını düzenleyin ve aşağıdaki söz dizimini kullanarak JMX kullanıcı adınızı ve şifrenizi ekleyin:

      JMX_USERNAME JMX_PASSWORD

      JMX_USERNAME ve JMX_PASSWORD, daha önce ayarladığınız JMX kullanıcı adı ve şifresidir.

   3. Dosyanın "apigee"ye ait olduğundan ve dosya modunun 400 olduğundan emin olun:

      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.password

4. jmxremote.access dosyasını kopyalayıp düzenleyin:
   1. Aşağıdaki dosyayı $JAVA_HOME dizininizden /opt/apigee/customer/application/apigee-cassandra/ dizinine kopyalayın:

      cp ${JAVA_HOME}/lib/management/jmxremote.access
      $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.access

   2. jmxremote.access dosyasını düzenleyin ve aşağıdaki rolü ekleyin:

      JMX_USERNAME readwrite

   3. Dosyanın "apigee"ye ait olduğundan ve dosya modunun 400 olduğundan emin olun:

      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.access

5. Cassandra'da configure komutunu çalıştırın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

6. Cassandra'yı yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

7. Bu işlemi diğer tüm Cassandra düğümlerinde tekrarlayın.

JMX şifrelemesini etkinleştirme

JMX şifre şifrelemesini etkinleştirmek için aşağıdaki adımları uygulayın:

1. source/conf/casssandra-env.sh dosyasını açın.
2. cassandra.properties dosyasını oluşturun ve düzenleyin:
   1. /opt/apigee/customer/application/cassandra.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
   2. Dosyaya aşağıdakileri ekleyin:

      conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true

   3. cassandra.properties dosyasını kaydedin.
   4. Aşağıdaki örnekte gösterildiği gibi, dosyanın sahibini apigee:apigee olarak değiştirin:

      chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

3. Komut satırında, echo -n 'Secret' | openssl dgst -sha1 komutunu girerek istediğiniz şifrelerin SHA1 karmalarını oluşturun.
4. $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password (önceki bölümde oluşturulan) içinde kullanıcı adı için şifreleri ayarlayın.
5. Cassandra'da yapılandırmayı çalıştırın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

6. Cassandra'yı yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

7. Bu işlemi diğer tüm Cassandra düğümlerinde tekrarlayın.

Cassandra için SSL ile JMX'i etkinleştirme

JMX'i SSL ile etkinleştirmek, Cassandra ile JMX tabanlı iletişim için ek güvenlik ve şifreleme sağlar. SSL ile JMX'i etkinleştirmek için Cassandra'ya SSL tabanlı JMX bağlantılarını kabul edecek bir anahtar ve sertifika sağlamanız gerekir. Ayrıca nodetool'u (ve Cassandra ile JMX üzerinden iletişim kuran diğer araçları) SSL için yapılandırmanız gerekir.

SSL özellikli JMX, hem düz metin hem de şifrelenmiş JMX şifrelerini destekler.

Cassandra için SSL ile JMX'i etkinleştirmek üzere aşağıdaki prosedürü uygulayın:

1. JMX'i etkinleştirin. Gerekirse şifre şifrelemeyi etkinleştirin.
2. Cassandra için JMX kimlik doğrulamasını etkinleştirin. gibi bir hata mesajı görürsünüz. Nodetool'un, yapılandırılmış kullanıcı adı ve şifreyle çalıştığından emin olun.

   /opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring

3. Anahtar deposunu ve güven deposunu hazırlayın.

   • Anahtar deposu, bir anahtar ve sertifika içermelidir ve Cassandra sunucusunu yapılandırmak için kullanılır. Anahtar deposunda birden fazla anahtar çifti varsa Cassandra, SSL'yi etkinleştirmek için ilk anahtar çiftini kullanır.

     Anahtar deposu ve anahtarın şifrelerinin aynı olması gerektiğini unutmayın (keytool kullanarak anahtarı oluşturduğunuzda varsayılan olarak aynıdır).

   • Güven deposu yalnızca sertifikayı içermelidir ve istemciler (apigee-service tabanlı komutlar veya nodetool) tarafından JMX üzerinden bağlanmak için kullanılır.

   Yukarıdaki koşulları doğruladıktan sonra:

   1. Anahtar deposu dosyasını /opt/apigee/customer/application/apigee-cassandra/ dizinine yerleştirin.
   2. Anahtar deposu dosyasının yalnızca Apigee kullanıcısı tarafından okunabildiğinden emin olmak için şunu girin:

      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/keystore.node1
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/keystore.node1

4. Aşağıdaki adımları uygulayarak Cassandra'yı SSL ile JMX için yapılandırın:
   1. Aşağıdaki komutu girerek Cassandra düğümünü durdurun:

      apigee-service apigee-cassandra stop

   2. /opt/apigee/customer/application/cassandra.properties dosyasını açıp aşağıdaki satırları ekleyerek Cassandra'da SSL'yi etkinleştirin:

      conf_cassandra_env_com.sun.management.jmxremote.ssl=true
      conf_cassandra_env_javax.net.ssl.keyStore=/opt/apigee/customer/application/apigee-cassandra/keystore.node1
      conf_cassandra_env_javax.net.ssl.keyStorePassword=keystore-password

   3. Aşağıdaki örnekte gösterildiği gibi, dosyanın sahibini apigee:apigee olarak değiştirin:

      chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

   4. Cassandra'da yapılandırmayı çalıştırın:

      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

   5. Cassandra'yı yeniden başlatın:

      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

   6. Bu işlemi diğer tüm Cassandra düğümlerinde tekrarlayın.
   7. Aşağıdaki komutu girerek Cassandra düğümünü başlatın:

      apigee-service apigee-cassandra start

5. apigee-service Cassandra komutlarını yapılandırın. apigee-service komutlarını çalıştırırken aşağıdakiler de dahil olmak üzere belirli ortam değişkenlerini ayarlamanız gerekir:

   apigee-service apigee-cassandra stop
   apigee-service apigee-cassandra wait_for_ready
   apigee-service apigee-cassandra ring
   apigee-service apigee-cassandra backup

   JMX kimlik doğrulaması ve SSL için apigee-service yapılandırmasıyla ilgili çeşitli seçenekler vardır. Kullanılabilirliğe ve güvenlik uygulamalarınıza göre bir seçenek belirleyin.

   • 1. seçenek (Dosyada depolanan SSL bağımsız değişkenleri)
   • 2. seçenek (Ortam değişkenlerinde depolanan SSL bağımsız değişkenleri)
   • 3. seçenek (SSL bağımsız değişkenleri doğrudan apigee-service aracına iletilir)

   1. seçenek (SSL bağımsız değişkenleri dosyada depolanır)

   Aşağıdaki ortam değişkenlerini ayarlayın:

   export CASS_JMX_USERNAME=ADMIN
   # Provide encrypted password here if you have setup JMX password encryption
   export CASS_JMX_PASSWORD=PASSWORD
   export CASS_JMX_SSL=Y

   Apigee kullanıcısının ana dizininde (/opt/apigee) bir dosya oluşturun.

   $HOME/.cassandra/nodetool-ssl.properties

   Dosyayı düzenleyin ve aşağıdaki satırları ekleyin:

   -Djavax.net.ssl.trustStore=<path-to-truststore.node1>
   -Djavax.net.ssl.trustStorePassword=<truststore-password>
   -Dcom.sun.management.jmxremote.registry.ssl=true

   Güvenilir depo dosyasının Apigee kullanıcısı tarafından okunabilir olduğundan emin olun.

   Aşağıdaki apigee-service komutunu çalıştırın. Komut hatasız çalışırsa yapılandırmalarınız doğrudur.

   apigee-service apigee-cassandra ring

   2. seçenek (Ortam değişkenlerinde depolanan SSL bağımsız değişkenleri)

   Aşağıdaki ortam değişkenlerini ayarlayın:

   export CASS_JMX_USERNAME=ADMIN
   # Provide encrypted password here if you have setup JMX password encryption
   export CASS_JMX_PASSWORD=PASSWORD
   export CASS_JMX_SSL=Y
   # Ensure the truststore file is accessible by Apigee user.
   export CASS_JMX_TRUSTSTORE=<path-to-trustore.node1>
   export CASS_JMX_TRUSTSTORE_PASSWORD=<truststore-password>

   Aşağıdaki apigee-service komutunu çalıştırın. Komut hatasız çalışırsa yapılandırmalarınız doğrudur.

   apigee-service apigee-cassandra ring

   3. seçenek (SSL bağımsız değişkenleri doğrudan apigee-service hizmetine iletilir)

   Aşağıdaki gibi bir apigee-service komutu çalıştırın. Herhangi bir ortam değişkeni yapılandırmanız gerekmez.

   CASS_JMX_USERNAME=ADMIN CASS_JMX_PASSWORD=PASSWORD CASS_JMX_SSL=Y CASS_JMX_TRUSTSTORE=<path-to-trustore.node1> CASS_JMX_TRUSTSTORE_PASSWORD=<trustore-password> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring

6. Nodetool'u ayarlayın. Nodetool, JMX parametrelerinin kendisine iletilmesini gerektirir. Aşağıdaki yapılandırma seçeneklerinde açıklandığı gibi, nodetool'u SSL özellikli JMX ile çalışacak şekilde yapılandırmanın iki yolu vardır:

   • 1. Yapılandırma Seçeneği
   • 2. Yapılandırma Seçeneği

   Seçenekler, SSL ile ilgili yapılandırmaların nodetool'a aktarılma şekline göre farklılık gösterir. Her iki durumda da nodetool'u çalıştıran kullanıcının güvenilir depo dosyasında OKUMA izinleri olmalıdır. Kullanılabilirliğe ve güvenlik uygulamalarınıza göre uygun bir seçenek belirleyin.

   Nodetool parametreleri hakkında daha fazla bilgi edinmek için DataStax belgelerine bakın.

   1. Yapılandırma Seçeneği

   nodetool'u çalıştıran kullanıcının ana dizininde bir dosya oluşturun.

   $HOME/.cassandra/nodetool-ssl.properties

   Dosyaya aşağıdaki satırları ekleyin:

   -Djavax.net.ssl.trustStore=<path-to-truststore.node1>
   -Djavax.net.ssl.trustStorePassword=<truststore-password>
   -Dcom.sun.management.jmxremote.registry.ssl=true

   Yukarıda belirtilen güvenilir depo yoluna, nodetool'u çalıştıran tüm kullanıcılar erişebilmelidir.

   nodetool komutunu --ssl seçeneğiyle çalıştırın.

   /opt/apigee/apigee-cassandra/bin/nodetool --ssl -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring

   Yapılandırma seçeneği 2

   nodetool komutunu, aşağıda listelenen ek parametrelerle birlikte tek bir komut olarak çalıştırın.

   /opt/apigee/apigee-cassandra/bin/nodetool -Djavax.net.ssl.trustStore=<path-to-truststore.node1> -Djavax.net.ssl.trustStorePassword=<truststore-password> -Dcom.sun.management.jmxremote.registry.ssl=true -Dssl.enable=true -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring

SSL yapılandırmalarını geri döndürme

Yukarıdaki prosedürde açıklanan SSL yapılandırmalarını geri almanız gerekiyorsa aşağıdaki adımları uygulayın:

1. için apigee-cassandra girerek

   apigee-service apigee-cassandra stop

2. /opt/apigee/customer/application/cassandra.properties dosyasından conf_cassandra-env_com.sun.management.jmxremote.ssl=true satırını kaldırın.
3. /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh dosyasındaki aşağıdaki satırları açıklama satırı yapın.

   # JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStore=/opt/apigee/data/apigee-cassandra/keystore.node0"
   # JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStorePassword=keypass"
   # JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.registry.ssl=true”

4. apigee-cassandra uygulamasını başlatmak için şunu girin:

apigee-service apigee-cassandra start

5. Ayarlanmışsa CASS_JMX_SSL ortam değişkenini kaldırın.

   unset CASS_JMX_SSL

6. ring, stop, backup gibi apigee-service tabanlı komutların çalışıp çalışmadığını kontrol edin.
7. Nodetool ile --ssl anahtarını kullanmayı bırakın.

Cassandra için JMX kimlik doğrulamasını devre dışı bırakma

Cassandra için JMX kimlik doğrulamasını devre dışı bırakmak istiyorsanız:

1. /opt/apigee/customer/application/cassandra.properties paketini düzenleyin.
2. Dosyadaki şu satırı kaldırın:

   conf_cassandra-env_com.sun.management.jmxremote.authenticate=true

3. Cassandra'da yapılandırmayı çalıştırın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

4. Cassandra'yı yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

5. Bu işlemi diğer tüm Cassandra düğümlerinde tekrarlayın.

JConsole'u kullanma: Görev istatistiklerini izleme

JMX aracılığıyla sunulan JMX özelliklerini (MBean'ler) izlemek için JConsole'u ve aşağıdaki hizmet URL'sini kullanın:

service:jmx:rmi:///jndi/rmi://IP_address:7199/jmxrmi

Burada IP_address, Cassandra sunucusunun IP'sidir.

Cassandra JMX istatistikleri

Küme düğümlerini yönetmek için nodetool'u kullanma

Nodetool yardımcı programı, Cassandra için küme düğümlerini yöneten bir komut satırı arayüzüdür. Yardımcı programı /opt/apigee/apigee-cassandra/bin adresinde bulabilirsiniz.

Tüm Cassandra küme düğümlerinde aşağıdaki çağrılar yapılabilir:

1. Genel halka bilgileri (tek Cassandra düğümü için de mümkündür): Tüm düğümler için "Yukarı" ve "Normal" ifadelerini arayın.

   nodetool [-u username -pw password] -h localhost ring

   Yalnızca Cassandra için JMX kimlik doğrulamasını etkinleştirdiyseniz kullanıcı adınızı ve şifrenizi iletmeniz gerekir.

   Yukarıdaki komutun çıkışı aşağıdaki gibi görünür:

   Datacenter: dc-1
   ==========
   Address            Rack     Status State   Load    Owns    Token
   192.168.124.201    ra1      Up     Normal  1.67 MB 33,33%  0
   192.168.124.202    ra1      Up     Normal  1.68 MB 33,33%  5671...5242
   192.168.124.203    ra1      Up     Normal  1.67 MB 33,33%  1134...0484

2. Düğümler hakkında genel bilgiler (düğüm başına çağrı)

   nodetool [-u username -pw password]  -h localhost info

   Yukarıdaki komutun çıkışı aşağıdaki gibi görünür:

   ID                     : e2e42793-4242-4e82-bcf0-oicu812
   Gossip active          : true
   Thrift active          : true
   Native Transport active: true
   Load                   : 273.71 KB
   Generation No          : 1234567890
   Uptime (seconds)       : 687194
   Heap Memory (MB)       : 314.62 / 3680.00
   Off Heap Memory (MB)   : 0.14
   Data Center            : dc-1
   Rack                   : ra-1
   Exceptions             : 0
   Key Cache              : entries 150, size 13.52 KB, capacity 100 MB, 1520781 hits, 1520923 requests, 1.000 recent hit rate, 14400 save period in seconds
   Row Cache              : entries 0, size 0 bytes, capacity 0 bytes, 0 hits, 0 requests, NaN recent hit rate, 0 save period in seconds
   Counter Cache          : entries 0, size 0 bytes, capacity 50 MB, 0 hits, 0 requests, NaN recent hit rate, 7200 save period in seconds
   Token                  : 0

3. Thrift sunucusunun durumu (istemci API'sini sunar)

   nodetool [-u username -pw password] -h localhost statusthrift

   Yukarıdaki komutun çıkışı aşağıdaki gibi görünür:
   

   running

4. Veri akışı işlemlerinin durumu: Cassandra düğümleri için trafiği gözlemleyin:

   nodetool [-u username -pw password] -h localhost netstats

   Yukarıdaki komutun çıkışı aşağıdaki gibi görünür:
   

   Mode: NORMAL
   Not sending any streams.
   Read Repair Statistics:
   Attempted: 151612
   Mismatch (Blocking): 0
   Mismatch (Background): 0
   Pool Name                    Active   Pending      Completed   Dropped
   Commands                        n/a         0              0         0
   Responses                       n/a         0              0       n/a

Nodetool hakkında daha fazla bilgi için Nodetool yardımcı programı hakkında başlıklı makaleyi inceleyin.

Cassandra kaynağı

Şu URL'yi inceleyin: http://www.datastax.com/docs/1.0/operations/monitoring.

Apache ZooKeeper

ZooKeeper durumunu kontrol etme

1. ZooKeeper işleminin çalıştığından emin olun. ZooKeeper, opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid dizinine bir PID dosyası yazar.
2. Her ZooKeeper sunucusunda 2181 ve 3888 numaralı bağlantı noktalarına TCP bağlantısı kurabildiğinizden emin olmak için ZooKeeper bağlantı noktalarını test edin.
3. ZooKeeper veritabanındaki değerleri okuyabildiğinizden emin olun. ZooKeeper istemci kitaplığı (veya /opt/apigee/apigee-zookeeper/bin/zkCli.sh) kullanarak bağlanın ve veritabanından bir değer okuyun.
4. Durumu kontrol edin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper status

ZooKeeper dört harfli kelimelerini kullanma

ZooKeeper, netcat (nc) veya telnet kullanılarak 2181 numaralı bağlantı noktasına gönderilen küçük bir komut grubu (dört harfli kelimeler) aracılığıyla izlenebilir.

ZooKeeper komutları hakkında daha fazla bilgi için Apache ZooKeeper komut referansı başlıklı makaleyi inceleyin.

Örneğin:

• srvr: Sunucuyla ilgili tüm ayrıntıları listeler.
• stat: Sunucu ve bağlı istemcilerle ilgili kısa ayrıntıları listeler.

ZooKeeper bağlantı noktasına aşağıdaki komutlar verilebilir:

1. Sunucunun hatasız durumda çalışıp çalışmadığını test etmek için dört harfli ruok komutunu çalıştırın. Başarılı bir yanıt "imok" döndürür.

   echo ruok | nc host 2181

   Şunu döndürür:

   imok

2. Sunucu performansını ve bağlı istemci istatistiklerini listelemek için dört harfli stat komutunu çalıştırın:

   echo stat | nc host 2181

   Şunu döndürür:

   Zookeeper version: 3.4.5-1392090, built on 09/30/2012 17:52 GMT
   Clients:
   /0:0:0:0:0:0:0:1:33467[0](queued=0,recved=1,sent=0)
   /192.168.124.201:42388[1](queued=0,recved=8433,sent=8433)
   /192.168.124.202:42185[1](queued=0,recved=1339,sent=1347)
   /192.168.124.204:39296[1](queued=0,recved=7688,sent=7692)
   Latency min/avg/max: 0/0/128
   Received: 26144
   Sent: 26160
   Connections: 4
   Outstanding: 0
   Zxid: 0x2000002c2
   Mode: follower
   Node count: 283

3. Netcat (nc) kullanılamıyorsa alternatif olarak Python'u kullanabilirsiniz. Aşağıdakileri içeren zookeeper.py adlı bir dosya oluşturun:

   import time, socket,
   sys c = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
   c.connect((sys.argv[1], 2181))
   c.send(sys.argv[2])
   time.sleep(0.1)
   print c.recv(512)

   Şimdi aşağıdaki Python satırlarını çalıştırın:

   python zookeeper.py 192.168.124.201 ruok
   python zookeeper.py 192.168.124.201 stat

LDAP seviyesi testi

Belirli isteklerin düzgün şekilde sunulup sunulmadığını görmek için OpenLDAP'yi izleyebilirsiniz. Başka bir deyişle, doğru sonucu döndüren belirli bir arama olup olmadığını kontrol edin.

1. Sistem yöneticisinin girişini sorgulamak için ldapsearch (yum install openldap-clients) kullanın. Bu giriş, tüm API çağrılarının kimliğini doğrulamak için kullanılır.

   ldapsearch -b "uid=admin,ou=users,ou=global,dc=apigee,dc=com" -x -W -D "cn=manager,dc=apigee,dc=com" -H ldap://localhost:10389 -LLL

   Ardından LDAP yönetici şifresi istenir:

   Enter LDAP Password:

   Şifreyi girdikten sonra aşağıdaki biçimde bir yanıt görürsünüz:

   dn:
   uid=admin,ou=users,ou=global,dc=apigee,dc=com
   objectClass: organizationalPerson
   objectClass: person
   objectClass: inetOrgPerson
   objectClass: top
   uid: admin
   cn: admin
   sn: admin
   userPassword:: e1NTSEF9bS9xbS9RbVNXSFFtUWVsU1F0c3BGL3BQMkhObFp2eDFKUytmZVE9PQ=
    =
   mail: opdk@google.com

2. Aşağıdaki komutla Yönetim Sunucusu'nun LDAP'ye hâlâ bağlı olup olmadığını kontrol edin:

   curl -u userEMail:password http://localhost:8080/v1/users/ADMIN

   Şunu döndürür:

   {
     "emailId" : ADMIN,
     "firstName" : "admin",
     "lastName" : "admin"
   }

Disk erişimlerinin sayısını azaltmaya ve dolayısıyla sistemin performansını artırmaya yardımcı olan OpenLDAP önbelleklerini de izleyebilirsiniz. OpenLDAP sunucusundaki önbellek boyutunu izlemek ve ardından ayarlamak, dizin sunucusunun performansını önemli ölçüde etkileyebilir. Önbellek hakkında bilgi edinmek için günlük dosyalarını (opt/apigee/var/log) görüntüleyebilirsiniz.