Cerebro, Elasticsearch için açık kaynaklı bir yönetim aracıdır. Hafif yapısı sayesinde hızlı başlar. Tarayıcı tabanlı bir arayüz üzerinden küme sağlığını görüntülemenize, dizin verilerini yönetmenize ve arama sorguları çalıştırmanıza olanak tanır. Geliştiriciler ve operasyon mühendisleri, Elasticsearch kümelerini hızla incelemek ve yönetmek için bu aracı kullanır.
Önkoşullar
Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:
Bir Alibaba Cloud Elasticsearch kümesi (sonraki adımda küme uç noktası gerekir)
Elasticsearch kümesiyle aynı Virtual Private Cloud (VPC) içinde çalışan veya genel ağ erişimi etkinleştirilmiş Linux işletim sistemli bir Elastic Compute Service (ECS) örneği
ECS örneğinde yüklü Java Development Kit (JDK) 1,8 veya sonraki bir sürüm. Kurulum adımları için bkz. OpenJDK'yı manuel olarak dağıtma.
Küme uç noktasını alma
Cerebro, Elasticsearch kümenize özel veya genel bir uç nokta üzerinden bağlanır.
VPC özel uç noktası: Düşük gecikme süresi ve yüksek kararlılık sağlayan iç ağ üzerinden bağlantı kurar. Küme oluşturulduktan sonra varsayılan olarak etkindir.
Genel uç nokta: İnternet üzerinden bağlantı kurar. Manuel olarak etkinleştirilmesi gerekir.
Çoğu kurulum senaryosunda VPC özel uç noktasını kullanın. Cerebro'yu çalıştıran ECS örneği, kümenin VPC'si dışında olduğunda yalnızca genel uç noktayı etkinleştirin.
Genel ağ erişimini etkinleştirme
Elasticsearch konsoluna giriş yapın ve kümenizin Basic Information sayfasına gidin.
-
Sol gezinme bölmesinde Configuration and Management > Security Settings seçeneğini belirleyin, ardından genel ağ erişimini etkinleştirin. Küme durumunun Initializing durumundan Valid durumuna geçmesini bekleyin.
ÖnemliGenel uç nokta kullanmak küme güvenliğini azaltır. Bir IP adresi izin listesi yapılandırın ve kullanım tamamlandıktan sonra genel ağ erişimini derhal devre dışı bırakın.

IP adresi izin listesi ayarlama
Cerebro'yu çalıştıran cihazın IP adresini kümenin izin listesine ekleyin. Yalnızca IP adresi izin listesinde bulunan cihazlar kümeye bağlanabilir.
Adım 1: Eklenecek IP adresini bulma
| Senaryo | Eklenecek IP adresi | Nasıl bulunur |
|---|---|---|
| Yerel bir cihazdan bağlanma | Cihazın genel IP adresi. Cihaz bir yerel alan ağı (LAN) arkasındaysa (örneğin ev veya kurumsal ağ), LAN'in genel giden IP adresini kullanın. | Cihazda curl ipinfo.io/ip komutunu çalıştırın. |
| Farklı bir VPC'deki bir ECS örneğinden bağlanma | ECS örneğinin genel IP adresi | ECS konsoluna giriş yapın ve örnek listesini kontrol edin. |
| Aynı VPC'deki bir ECS örneğinden bağlanma | ECS örneğinin özel IP adresi | ECS konsoluna giriş yapın ve örnek listesini kontrol edin. |
Adım 2: IP adresini izin listesine ekleme
Elasticsearch konsoluna giriş yapın ve kümenizin Basic Information sayfasına gidin. Gezinti bölmesinde Configuration and Management > Security Settings seçeneğini belirleyin.
-
İzin listesi iletişim kutusunu açmak için Modify öğesine tıklayın.

-
Varsayılan grubun sağındaki Configure seçeneğine tıklayın ve IP adreslerinizi ekleyin.
Birden çok IP adresini veya CIDR bloğunu virgülle ayırın; önce veya sonra boşluk bırakmayın.
Tek bir küme en fazla 300 IP adresini veya CIDR bloğunu destekler.
Ayrı bir grup oluşturmak için Add IP Whitelist Group seçeneğine tıklayın. Gruplar yalnızca IP adresi yönetimi içindir; tüm gruplardaki IP'ler aynı erişim izinlerini paylaşır.
Önemliİzin listesini
0.0.0.0/0veya::/0olarak ayarlamayın. Bu yapılandırmalar herhangi bir IP adresinden erişime izin verir ve önemli bir güvenlik riski oluşturur. Bazı küme sürümleri (örneğin 7.16 ve 8.5) ve bölgeler bu değerleri desteklemez. IPv6 izin listesi desteği, yalnızca China (Hangzhou) bölgesindeki v2 dağıtım mimarisini kullanan kümelerle sınırlıdır.Desteklenen biçimler:
Tür Biçim Örnek Tek IPv4 adresi A.B.C.D192.168.0.1IPv4 CIDR bloğu A.B.C.D/N192.168.0.0/24Tüm IPv4 erişimini engelleme — 127.0.0.1Tüm IPv4 erişimine izin verme (yüksek risk) — 0.0.0.0/0Tek IPv6 adresi — 2401:XXXX:1000:24::5IPv6 CIDR bloğu — 2401:XXXX:1000::/48Tüm IPv6 erişimini engelleme — ::1Tüm IPv6 erişimine izin verme (yüksek risk) — ::/0
-
Confirm öğesine tıklayın.

Cerebro'yu yükleme ve kümeye bağlanma
1. Cerebro'yu yükleme ve yapılandırma
ECS örneğinize bağlanın. Aşağıdaki adımlar Linux sistemi kullanılarak gösterilmiştir. Bağlantı talimatları için bkz. Bir ECS örneğine bağlanma.
ECS örneğine JDK 1,8 veya sonraki bir sürümü yükleyin. Bkz. OpenJDK'yı manuel olarak dağıtma.
-
Cerebro paketini indirin ve çıkarın.
Bu örnekte v0.9.0 kullanılmaktadır. En son sürümü kullanmak için Cerebro releases sayfasını kontrol edin ve indirme URL'sini buna göre güncelleyin.
# Download Cerebro v0.9.0 wget https://github.com/lmenezes/cerebro/releases/download/v0.9.0/cerebro-0.9.0.tgz # Extract the package tar -zxvf cerebro-0.9.0.tgz -
Cerebro yapılandırma dosyasını açın.
vim cerebro-0.9.0/conf/application.conf -
Cerebro'yu Elasticsearch kümenize yönlendirmek için
hostsparametresini yapılandırın, ardından dosyayı kaydedin.Cerebro'yu birden çok kümeye bağlamak için
hostsdizisine virgülle ayrılmış birden çok giriş ekleyin.Parametre Açıklama hostKüme uç noktası. Özel erişim için http://<VPC private endpoint>:9200veya genel erişim içinhttp://<public endpoint>:9200kullanın. ES kümelerinde HTTP varsayılan olarak etkindir. Trafiği şifrelemek için Configuration and Management > Security Settings bölümünden HTTPS'yi etkinleştirin. HTTPS'yi etkinleştirmeden önce uygulama kodunuzu HTTPS bağlantılarını destekleyecek şekilde güncelleyin; mevcut HTTP tabanlı kod çalışmayı durduracaktır.nameElasticsearch küme kimliğiniz. Elasticsearch konsolundaki küme listesinde bulabilirsiniz. usernameKüme için kullanıcı adı. Varsayılan olarak tam küme izinlerine sahip olan elastickullanılır. Üretim ortamları için bunun yerine Elasticsearch X-Pack rol yönetimi kullanarak kapsamlı izinlere sahip özel kullanıcılar oluşturun.passwordBelirtilen kullanıcı için parola. # A list of known hosts hosts = [ #{ # host = "http://localhost:9200" # name = "Localhost cluster" # headers-whitelist = [ "x-proxy-user", "x-proxy-roles", "X-Forwarded-For" ] #} # Example of host with authentication { host = "http://es-cn-xxx.elasticsearch.aliyuncs.com:9200" name = "es-cn-xxx" auth = { username = "elastic" password = "xxx" } } ]
2. Cerebro hizmetini başlatma
Ön planda başlatma (hata ayıklama için):
cd cerebro-0.9.0
bin/cerebro
Cerebro başarıyla başladığında terminalde bir onay mesajı görünür.
[root@VM01 cerebro-0.9.0]# bin/cerebro
[info] play.api.Play - Application started (Prod) (no global state)
[info] p.c.s.AkkaHttpServer - Listening for HTTP on /0.0.0.0:9000
Arka planda başlatma (üretim ortamları için):
cd cerebro-0.9.0
nohup bin/cerebro > cerebro.log 2>&1 &
Günlükleri görüntülemek için: tail -f cerebro.log
Hizmeti durdurmak için: pkill -f cerebro
3. Tarayıcıda Cerebro'yu açma ve kümeye bağlanma
ECS güvenlik grubunda, Cerebro'ya erişmek istediğiniz cihazın IP adresinden gelen trafiğe yönelik 9000 numaralı bağlantı noktasını açın. Adımlar için bkz. Bir güvenlik grubu kuralı ekleme.
Tarayıcıda
http://<Public IP address of the ECS instance>:9000adresine gidin.Cerebro oturum açma sayfasında,
application.confdosyasında yapılandırılan kümeler görünür. Bağlanmak için bir kümeye tıklayın.-
Bağlandıktan sonra Cerebro konsolu küme sağlığını, dizinleri ve diğer yönetim seçeneklerini görüntüler.
Bağlandıktan sonra Cerebro konsolu küme durumunu yeşil olarak gösterir. Küme genel bakışı düğüm sayısını (2 düğüm), dizin sayısını (22 dizin), parça sayısını (44 parça), belge sayısını ve depolama boyutunu içerir. Genel bakışın altında her dizin için parça dağılımını ve her düğüm için yığın, disk, CPU ve yük ölçümlerini görüntüleyebilirsiniz.
Cerebro kullanımı hakkında daha fazla bilgi için bkz. Cerebro belgeleri.
Sorun giderme
Cerebro başlamıyor
Aşağıdakileri kontrol edin:
JDK yüklü değil veya sürüm 1,8'den eski. Doğrulamak için
java -versionkomutunu çalıştırın. Sürüm 1,8'den düşükse uyumlu bir JDK yükleyin.9000 numaralı bağlantı noktası zaten kullanımda.
application.confdosyasındahttp.portdeğerini farklı bir değere ayarlayarak bağlantı noktasını değiştirin.Başlatma betiğinde yürütme izinleri eksik. İzinleri eklemek için
chmod +x bin/cerebrokomutunu çalıştırın.
Elasticsearch kümesine bağlanılamıyor
Aşağıdakileri kontrol edin:
IP adresi izin listesi yapılandırılmamış. Cerebro ana bilgisayarının IP adresinin Elasticsearch konsolunda doğru izin listesine (VPC özel veya genel) eklendiğini doğrulayın.
Yapılandırmada yanlış uç nokta veya bağlantı noktası.
application.confdosyasındakihostdeğerinin küme uç noktasıyla eşleştiğini ve 9200 numaralı bağlantı noktasını kullandığını onaylayın.ECS güvenlik grubu trafiği engelliyor. Güvenlik grubunun 9200 (Elasticsearch) ve 9000 (Cerebro) numaralı bağlantı noktalarında gelen trafiğe izin verdiğini onaylayın.
Yanlış kullanıcı adı veya parola.
application.confdosyasındaki kimlik bilgilerinin doğru olduğunu doğrulayın.