Elastalert genel bir yapılandırma dosyasına sahiptir(config.yaml). Elastalert yapılandırma dosyaları YAML dosyasıdır.
*Kurallar içinde yapılandırma dosyası oluşturacağımızdan hepsini bir dizinde toplamak kolaylık olabilir.
Örnek config.yaml
# The unit can be anything from weeks to seconds
run_every:
minutes: 1
# ElastAlert will buffer results from the most recent
# period of time, in case some log sources are not in real time
buffer_time:
minutes: 5
# The elasticsearch hostname for metadata writeback
# Note that every rule can have it's own elasticsearch host
es_host: elk-elasticsearch
# The elasticsearch port
es_port: 9200
# Optional URL prefix for elasticsearch
#es_url_prefix: elasticsearch
# Connect with SSL to elasticsearch
use_ssl: False
# Option basic-auth username and password for elasticsearch
#es_username: someusername
#es_password: somepassword
# The index on es_host which is used for metadata storage
# This can be a unmapped index, but it is recommended that you run
# elastalert-create-index to set a mapping
writeback_index: elastalert_status
# If an alert fails for some reason, ElastAlert will retry
# sending the alert until this time period has elapsed
alert_time_limit:
days: 1
Örnek Yapılandırma dosyasında var olan seçenek dışında kullanacağınız yapılandırma alanları da vardır:
rules_folder: ElastAlertden gelen kural yapılandırma dosyalarının yolu yazılır.
run_every: Elastalertin Elasticserch sorgu sıklığıdır. Verilen kural çalıştığında zamanı tutar ve şimdiki zamandan itibaren periyodik olarak sorgular. Bu alanın biçimi "minute"
es_host: Elastalert'in aramalarıyla ilgili metadataları kaydeden Elasticserch'un makine adıdır.
es_port: es_host makinesine erişmek için kullanılan porttur.
use_ssl: es_host bağlanırken SSL kullanmak isteyip istemediğimizi değerine 'True', 'False' vererek ayarlayabiliriz.
es_hostname: es_host a bağlanırken otomatik bağlanmak için kullanıcı adı
es_password: es_host a bağlanırken otomatik bağlanmak için parola
es_url_prefix: Elasticserch endpoint için url alan kodu.
es_send_get_body_as: Elasticsearh sorgulaması için metot. GET, POST ve source olabilir. Varsayılan Get dir.
es_counn_timeout: Bağlanma ve es_host'u okumak için zaman aşımı ayrlar. Varsayılan olarak 10 dur.
scan_subdirectories: Ayar yapılmadığında veya elastalert kural dizinini yeniden indirmeyeceginde. True veya False Varsayılan olarak True.
writeback_index: Elasticsearch de kaydedilen verileri indekslemek için kullanılır. 3 farklı tipi vardır.
1)elastalert_status
2)elastalert
3)elastalert_error
scroll_keepalive :Maksimum sürede akan bağlantılar anlık yakalanmalı. Fakat sonuçların bitirilmesini sağlamak için dikkatli değer vermeliyiz. Yüksek değer verdiğimiz zaman elasticserch kaynaklarını kötüye kullanır.(Format time units)
old_query_limit: Elastalert için sorgular arasındaki maksimum sürede en son çalıştırılan sorguyu başlatır. Varsayılan olarak one week
disable_rules_on_error: Eğer True ise, Elastalert yakalanmayan exception kurallarını yok sayar. Varsayılan olarak True.
notify_email: email bildirimi göndermek için. Varsayılan olarak True dur.
notify_email: Bildirim göndermek istediği email ya da email listesi. Varsayılan olark email göndermez.
options:from_addr: Adres email bildirimlerinde başlık kullanır. Varsayılan değer 'Elastalert' dir.
stmp_host: Email bildirimi göndermek için kullanılan stmp ana makie adı.
email_replay_to: Varsayılan olarak alıcı adresidir.
Konteynırdan elastalerti çalıştırmak için elastalert.py dosyasını çalıştırmanız gerekir. Çalıştırırken sizden config dosyasını isteyecektir. config.yaml dosyasının yolunu --config parametresiyle belirtmek gerekir.
# python /opt/elastalert/elastalert/elastalert.py --config opt/elastalert/config.yaml
Hiç yorum yok:
Yorum Gönder