Application Real-Time Monitoring Service (ARMS) Java aracısını uygulamanıza ekleyerek izlemeleri, uygulama topolojisini, anormal ve yavaş işlem verilerini ve SQL analizlerini toplayabilirsiniz.
Container Service for Kubernetes (ACK) kümelerinde dağıtılan uygulamalar için bunun yerine ack-onepilot bileşenini yükleyin. Bkz. ACK'de ARMS aracısını otomatik olarak yükleme veya Açık kaynaklı Kubernetes kümesinde ARMS aracısını otomatik olarak yükleme.
Ön koşullar
Başlamadan önce aşağıdaki koşulları sağladığınızdan emin olun:
Ağınız ARMS aracısı bağlantı gereksinimlerini karşılamalıdır.
JDK sürümünüz Uygulama İzleme tarafından desteklenen sürümlerden biri olmalıdır.
JVM maksimum yığın belleği (
-Xmx) en az 256 MB olmalıdır.
ARMS aracısını yükleme
Adım 1: Aracıyı indirme
ARMS konsolu üzerinde oturum açın.
Sol gezinme bölmesinde Integration Center seçeneğine tıklayın.
Java Application Monitor kartına tıklayın ve ardından Manual Installation öğesini seçin.
-
Aracı paketini aşağıdaki yöntemlerden birini kullanarak indirin:
Konsoldan -- Java Application Monitor panelindeki indirme talimatlarını takip edin.
Komut satırından -- Bölgenize uygun
wgetkomutunu çalıştırın. Aşağıdaki tablodan bölgenizi seçin.
Adım 2: Aracı paketini çıkarma
İndirilen ZIP dosyasını bir çalışma dizinine çıkarın:
unzip AliyunJavaAgent.zip -d <working-directory><working-directory> ifadesini, aracıyı yüklemek istediğiniz dizinle değiştirin; örneğin /opt/arms.
Adım 3: Lisans anahtarını ve uygulama adını yapılandırma
ARMS aracısının veri raporlayabilmesi için iki parametre gerekir:
|
|
|
|
|
|
|
|
|
|
|
|
Bu parametreleri aşağıdaki iki yöntemden biriyle aktarın:
Seçenek A: JVM argümanları olarak geçirme (önerilir)
-Darms.licenseKey ve -Darms.appName parametrelerini başlatma komutuna doğrudan ekleyin. Tam komut için 4. Adımı inceleyin.
Seçenek B: Yapılandırma dosyası kullanma
Bu yaklaşım, birden fazla uygulamanın tek bir başlatma betiğini paylaştığı durumlarda kullanışlıdır.
Öncelikle, çıkarılan dizindeki version dosyasında aracı sürümünü kontrol edin.
ARMS agent V4.0.0 or later:
Aracı dizininde arms-agent.properties adlı bir dosya oluşturun:
arms.licenseKey=<your-license-key>
arms.appName=<your-app-name>Ardından başlatma komutunuza aşağıdakilerden birini ekleyin:
JVM argümanı:
-Dotel.javaagent.configuration-file=/path/to/arms-agent.propertiesOrtam değişkeni:
OTEL_JAVAAGENT_CONFIGURATION_FILE=/path/to/arms-agent.properties
ARMS agent earlier than V4.0.0:
Aracı dizinindeki arms-agent.config dosyasını düzenleyin:
arms.licenseKey=<your-license-key>
arms.appName=<your-app-name>Diğer aracı parametreleriyle ilgili ayrıntılar için bkz. ARMS aracı parametrelerini ve veri raporlama bölgelerini değiştirme.
Adım 4: Aracıyı başlatma komutuna ekleme
Başlatma komutunuza -javaagent seçeneğini ekleyin. Söz dizimi çalışma zamanı ortamına göre değişir.
Aşağıdaki yer tutucuları gerçek değerlerinizle değiştirin:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Spring Boot veya java -jar
-javaagent seçeneğini -jar bağımsız değişkeninden önce yerleştirin:
java -javaagent:/<working-directory>/AliyunJavaAgent/aliyun-java-agent.jar \
-Darms.licenseKey=<your-license-key> \
-Darms.appName=<your-app-name> \
-jar demoApp.jarTomcat
{TOMCAT_HOME}/bin/setenv.sh dosyasına aşağıdaki satırı ekleyin:
JAVA_OPTS="$JAVA_OPTS -javaagent:/<working-directory>/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey=<your-license-key> -Darms.appName=<your-app-name>"setenv.sh dosyası yoksa aynı yapılandırmayı {TOMCAT_HOME}/bin/catalina.sh dosyasındaki JAVA_OPTS parametresine ekleyin. Referans için catalina.sh 256. satır bölümüne bakın.
Jetty
{JETTY_HOME}/start.ini dosyasının sonuna aşağıdakileri ekleyin:
--exec
-javaagent:/<working-directory>/AliyunJavaAgent/aliyun-java-agent.jar
-Darms.licenseKey=<your-license-key>
-Darms.appName=<your-app-name>Aynı sunucuda birden fazla örnek
Bir sunucuda aynı uygulamanın birden fazla örneğini çalıştırmak için JVM işlemlerini ayırt etmek amacıyla benzersiz bir değerle -Darms.agentId parametresini ekleyin:
java -javaagent:/<working-directory>/AliyunJavaAgent/aliyun-java-agent.jar \
-Darms.licenseKey=<your-license-key> \
-Darms.appName=<your-app-name> \
-Darms.agentId=001 \
-jar demoApp.jarV2.7.3.5 öncesi aracı sürümlerinde
AliyunJavaAgent/aliyun-java-agent.jaryerineArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jarkullanın. En kısa sürede en son sürüme yükseltmeniz önerilir.Windows'ta yollardaki
/karakterini\ile değiştirin ve.shdosyaları yerine.batdosyalarını kullanın.Uygulama Güvenliğini (V2.7.1.4'ten itibaren kullanılabilir) etkinleştirmek için
-Darms.appsec.enable=trueekleyin. Fiyatlandırma bilgisi için bkz. Uygulama Güvenliği faturalandırması.
Adım 5: Uygulamayı yeniden başlatma
Aracının etkili olması için Java uygulamanızı yeniden başlatın.
(İsteğe bağlı) Docker ile yükleme
ARMS aracısını bir Docker görüntüsüne yüklemek için aşağıdaki Dockerfile'ı şablon olarak kullanın:
# Replace <your-base-image:tag> with your image
FROM <your-base-image:tag>
WORKDIR /root/
# Download the agent (use the URL for your region; see Step 1)
RUN wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/AliyunJavaAgent.zip" -O AliyunJavaAgent.zip
RUN unzip AliyunJavaAgent.zip -d /root/
# Set credentials as environment variables
ENV arms_licenseKey=<your-license-key>
ENV arms_appName=<your-app-name>
# Inject the agent via JAVA_TOOL_OPTIONS
ENV JAVA_TOOL_OPTIONS ${JAVA_TOOL_OPTIONS} '-javaagent:/root/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey='${arms_licenseKey}' -Darms.appName='${arms_appName}
# Verify the environment variable
RUN env | grep JAVA_TOOL_OPTIONS
# Add your application-specific instructions below
# ...Yüklemeyi doğrulama
Uygulamayı yeniden başlattıktan sonra aracı yaklaşık bir dakika içinde veri raporlamaya başlar.
ARMS konsolunda Application Monitoring > Application List yolunu izleyin.
Uygulamanızın listede göründüğünden ve veri kayıtlarının gönderildiğinden emin olun.
Uygulamanız birkaç dakika sonra görünmüyorsa aşağıdakileri kontrol edin:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Daha fazla sorun giderme rehberi için bkz. Uygulama İzleme SSS.