Öncelik sırası açıktır. JVM -D ve environment değerleri dış property dosyasını ezer. Dış dosya
classpath içindeki rust-spring.properties değerini ezer. RuntimeProfilePlan yalnız eksik uygulama
varsayılanlarını tamamlar.
| Hedef | Başlangıç | Yalnız ölçerek değiştirin |
|---|---|---|
| En düşük pratik REST RSS | reactor.runtime.profile=micro-rest |
JNI worker, response pool, max connection |
| Ağır producer JSON | micro-rest-plus ve named route budget |
max-concurrent, queue-timeout-ms |
| En yüksek RPS | balanced veya throughput |
Pod CPU/RSS limitine göre worker ve queue |
| Büyük dosya | FileResponse |
reactor.rust.static-file.max-concurrent-streams |
| WebSocket | Yalnız gereken artifact'te açın | Frame boyutu ve outbound queue kapasitesi |
Framework'ün tüm property dosyasını her servise kopyalamayın. Local varsayılanları küçük tutun. Production gate ve ileri tuning değerlerini ayrı overlay dosyalarında yönetin.
META-INF/reactor/properties.idx, build-time @RustProperty envanteridir. Secret saklamaz ve runtime
config kaynağı değildir.
| Production gate | Varsayılan | Ne zaman açılır? |
|---|---|---|
reactor.optimizer.fail-on-reflection-route-metadata |
false |
/diagnostics/routes tüm production route'larda generated metadata gösterdiğinde |
reactor.optimizer.fail-on-fallback |
false |
Gerekli route'lar hedeflenen compiled, direct veya native yolu kullandığında |
reactor.optimizer.fail-on-heavy-json-object-graph |
false |
Ağır route'lar producer, direct, raw, file veya native response yoluna taşındığında |
Bu gate'leri migration tamamlandıktan sonra açın. Kontroller startup sırasında çalışır. Request hot path'ine ek yük getirmez.
Bu ayarlar yalnız kullanılmayan gözlem verisini bellekten çıkarır.
| Property | Varsayılan | Ne yapar? | Ne zaman değiştirilir? |
|---|---|---|---|
reactor.metrics.collection-enabled |
false |
Built-in metrics route'ları kayıtlı değilken de Java counter, gauge ve histogram verisini tutar | Uygulama kodu Metrics sınıfını doğrudan okuyorsa ve @ReactorApplication(metrics = true) veya RestApplication.Builder.metrics() kullanılmıyorsa true yapın |
reactor.optimizer.retain-route-plans |
auto |
auto, metrics veya runtime route metrics açıksa detaylı planları tutar; aksi durumda startup kontrolü bitince plan nesnelerini bırakır |
Built-in metrics olmadan özel route diagnostics kullanıyorsanız true yapın; startup sonrasında route detayı bilinçli olarak gerekmiyorsa false kullanın |
@ReactorApplication(metrics = true) ve RestApplication.Builder.metrics() Java metrics toplamayı
her zaman açar. Metrics'i kapatmak Rust tarafındaki native HTTP sayaçlarını kaldırmaz. Yalnız hiçbir
endpoint'in okumadığı Java registry verisinin bellekte tutulmasını engeller.
Stable 4.6.3 runtime REST ABI 29 ve Glowroot ABI 6 kullanır. Sınırlı profiller çalışma sırasında
değiştirilebilir. Bu Java sınıflarını Glowroot ABI 3 DLL/SO dosyasıyla karıştırmayın.
Glowroot Central ve Cassandra değişmez. Rust-Java REST için agent JAR gerekmez. Protobuf encode,
collector bağlantısı, profil state'i ve izole 256 KiB exporter thread'i native runtime'a aittir.
Hyper worker'ları kullanılmaz. İsteğe bağlı java-rust-glowroot-agent.jar yalnız erken
-javaagent argümanlarını property'lere çevirir.
| Property | Varsayılan | Kabul edilen değer | Ne işe yarar? |
|---|---|---|---|
reactor.glowroot.enabled |
false |
boolean | Sınırlı telemetri state'ini ve exporter'ı açar |
reactor.glowroot.profile |
micro |
micro, jvm, sql, full, diagnostic |
Başlangıç profilini seçer; API daha sonra değiştirebilir |
reactor.glowroot.profile.release-timeout-ms |
5000 |
100-60000 | Eski profile ait state'in bırakılması için en uzun senkron bekleme |
reactor.glowroot.collector.address |
http://127.0.0.1:8181 |
plaintext host:port veya http://host:port |
Glowroot Central gRPC over HTTP/2 adresi |
reactor.glowroot.agent.id |
boş | 1-256 byte | Zorunlu pod veya rollup kimliği |
reactor.glowroot.application.name |
uygulama adı | 1-128 byte | Glowroot ekranında görünen ad |
reactor.glowroot.hostname |
HOSTNAME |
en fazla 255 byte | Pod veya host kimliği |
reactor.glowroot.export.interval-ms |
60000 |
60000-3600000 ve 60000'in katı | Aggregate ve gauge gönderim aralığı |
reactor.glowroot.connect-timeout-ms |
1000 |
100-30000 | TCP/HTTP2 bağlantı zaman sınırı |
reactor.glowroot.request-timeout-ms |
2000 |
100-30000 | Tüm unary gRPC çağrısının zaman sınırı |
reactor.glowroot.trace.slow-threshold-ms |
500 |
1-3600000 | Startup kuyruğu varsa HTTP yavaş trace eşiği |
reactor.glowroot.http.sample-rate |
256 |
1-1024 arasında ikinin kuvveti | İsteğe bağlı HTTP trace ayrıntısını örnekler; endpoint sayısı, latency histogramı, throughput ve hatalar tam kalır |
reactor.glowroot.trace.capacity |
0 |
0-32 | Startup'ta ayrılan HTTP trace kuyruğu; 0 iken ayrılmaz |
reactor.glowroot.sql.capacity |
16 |
0-32 | Yalnız sql, full veya diagnostic açıkken ayrılan SQL slotu |
reactor.glowroot.error.trace.capacity |
8 |
0-16 | Yalnız hata profilleri açıkken tutulan hata ayrıntısı |
reactor.glowroot.error.max-frames |
24 |
0-32 | Bir hata için kopyalanacak en fazla stack frame sayısı |
reactor.glowroot.error.max-bytes |
4096 |
256-8192 | Bir hata ayrıntısının en fazla UTF-8 byte boyutu |
reactor.glowroot.max-routes |
64 |
1-64 | En fazla HTTP route slotu |
reactor.glowroot.max-export-bytes |
65536 |
16384-65536 | Encode edilen request için kesin üst sınır |
reactor.native.capabilities değerini açıkça veriyorsanız glowroot ekleyin:
reactor.native.capabilities=http,dubbo,redis,glowroot
reactor.glowroot.enabled=true
reactor.glowroot.profile=microKontrol API'sini kimlik doğrulaması olan iç operasyon akışından çağırın. Public endpoint veya request hot path üzerinden çağırmayın:
GlowrootTelemetry.switchTo(TelemetryProfile.FULL, Duration.ofSeconds(5));
// Olay inceleme aralığını sınırlı tutun.
GlowrootTelemetry.restoreConfiguredProfile();Her request'te profil değişimini otomatikleştirmeyin. SQL slotları, 25-bit nesil içeren ayrı ve
pozitif bir 32-bit kimlik kullanır. Eski slotlar normal process ömründe yeni SQL tanımıyla eşleşmez.
Runtime yalnız 33 milyon üzerindeki state-shape geçişinde sessiz wrap yerine hata verir.
Çağrı sıraya alınır ve senkrondur. restoreConfiguredProfile(), reactor.glowroot.profile ile seçilen
başlangıç değerine döner; micro değerini kod içinde sabitlemez. Temel profil micro ise dönüş
tamamlandığında SQL slotları, hata ve tanılama kuyrukları, profile ait export verisi ve Rust'ın sahip
olduğu JNI MXBean global referansları bırakılmıştır. Linux, son referans bırakıldıktan sonra izole agent
thread'inden malloc_trim(0) ister. Windows sahipliği bırakır, ancak bütün process için zorunlu
working-set boşaltma yapmaz.
İzole thread, Hyper worker'larını veya server Tokio runtime'ını kullanmaz. Buna rağmen glibc trim çağrısı process genelindedir. Profil değişimini request akışında değil, seyrek bir kontrol düzlemi işlemi olarak kullanın. RSS etkisini tek bir geçiş sonrası değerle değil, telemetri kapalı/açık taze process A/B testiyle ölçün.
Her normalize SQL için tek ve tekrar kullanılan descriptor oluşturun. Bind value eklemeyin. Her request için descriptor üretmeyin:
private static final GlowrootTelemetry.SqlStatement FIND_CUSTOMER =
GlowrootTelemetry.sql("customer.find", "select id, name from customer where id = ?");http.sample-rate ve trace.capacity startup ayarıdır. Profil geçişi bu kapasiteleri değiştirmez.
En sıkı micro kaynak bırakma davranışı için trace.capacity=0 kullanın. Her key normal uppercase
environment karşılığına sahiptir. Örneğin reactor.glowroot.profile.release-timeout-ms,
REACTOR_GLOWROOT_PROFILE_RELEASE_TIMEOUT_MS olur.