Bu rehber Ubuntu 24.04 LTS üzerinde yeni bir InfluxDB OSS 2.x kurulumu içindir. Zaman serisi verisini bir bucket’a yazıp aynı veriyi sorgulayacağız. InfluxDB 1.x, 2.x ve 3 aynı paket, API ve sorgu modeline sahip değildir; mevcut 1.x/3 kurulumu veya veri dizini üzerine bu adımları uygulamayın. InfluxDB 3 için ayrı resmî kurulum yolunu değerlendirin.
Görselin adım adım açıklaması
- Ölç: Her örneğe zaman damgası ekle.
- Yaz: Veriyi seçtiğin sürümün API’sine gönder.
- Sorgula: Aynı zaman aralığındaki ölçümleri karşılaştır.
- Sakla: Saklama süresini ihtiyaca göre belirle.
Ön koşullar ve erişim modeli
Sudo kullanıcısı, sunucu konsolu ve bir SSH istemcisi gerekir. İlk kurulumu yalnız loopback adresinden erişilebilir yapacağız; 8086 portunu genel ağa açmayacağız. Var olan InfluxDB servisi/verisi varsa önce sürümünü ve yedekleme/geçiş planını belirleyin.
cat /etc/os-release
dpkg-query -W 'influx*' 2>/dev/null
ss -lnt | awk '$4 ~ /:8086$/ {print}'
sudo apt-get update
sudo apt-get install ca-certificates curl gnupgİmzalı APT kaynağını ekleyin
Resmî 2.x kurulum belgesi, Ubuntu 24.04 için arşiv anahtarını ve signed-by kapsamlı depoyu gösterir. Aşağıdaki anahtar parmak izini belgeyle karşılaştırın. Sağlayıcı anahtar döndürmüşse doğrulamayı kaldırmak yerine güncel parmak izini resmî kaynaktan inceleyin.
key_dir=$(mktemp -d)
curl --fail --show-error --location \
https://repos.influxdata.com/influxdata-archive.key \
-o "$key_dir/influxdata-archive.key"
gpg --show-keys --with-colons "$key_dir/influxdata-archive.key"İlk birincil anahtarın fpr değeri 24C975CBA61A024EE1B631787C3D57159FC2F927 olmalıdır. Eşleşmiyorsa durun. Eşleşme doğrulandıktan sonra:
sudo install -d -m 755 /etc/apt/keyrings
gpg --dearmor --output "$key_dir/influxdata-archive.gpg" \
"$key_dir/influxdata-archive.key"
sudo install -m 644 "$key_dir/influxdata-archive.gpg" \
/etc/apt/keyrings/influxdata-archive.gpg
printf '%s\n' 'deb [signed-by=/etc/apt/keyrings/influxdata-archive.gpg] https://repos.influxdata.com/debian stable main' \
| sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt-get update
apt-cache policy influxdb2 influxdb2-cliAday paketlerin beklenen InfluxData kaynağından geldiğini ve sunucu paketinin 2.x olduğunu doğrulayın. apt-key veya imza denetimini kapatan APT seçenekleri kullanmayın.
İlk başlatmayı yerel adrese sınırlayın
Aşağıdaki mask işlemi yeni kurulumda paket yöneticisinin servisi yapılandırmadan önce başlatmasını önler. Mevcut üretim servisine uygulamayın.
sudo systemctl mask influxdb.service
sudo apt-get install influxdb2 influxdb2-cli
sudo install -d -m 755 /etc/systemd/system/influxdb.service.d
printf '%s\n' '[Service]' 'Environment=INFLUXD_HTTP_BIND_ADDRESS=127.0.0.1:8086' \
| sudo tee /etc/systemd/system/influxdb.service.d/listen-local.conf
sudo systemctl daemon-reload
sudo systemctl unmask influxdb.service
sudo systemctl enable --now influxdb.service
sudo systemctl status influxdb.service --no-pager
influxd version
influx version
ss -lnt | awk '$4 ~ /:8086$/ {print}'
curl --fail --show-error http://127.0.0.1:8086/healthDinleyici 127.0.0.1:8086 olmalıdır; 0.0.0.0 veya [::] görürseniz genel erişimi açmadan yapılandırmayı düzeltin. Sunucu ile CLI ayrı sürümlenir; numaralarının birebir aynı olması beklenmez.
Organizasyon, bucket ve ilk hesabı oluşturun
Sunucu üzerinde umask 077 ardından influx setup çalıştırın. Etkileşimli sorularda güçlü bir yönetici parolası, fibacloud-lab organizasyonu, metrics_lab bucket’ı ve örneğin 168h saklama süresi seçin. Saklama değeri bu laboratuvar için bir haftadır; gerçek ihtiyacı ayrıca belirleyin. Daha önce tamamlanmış kurulumda setup’ı tekrarlamayın.
CLI’nin yerel yapılandırması yetkili token içerebilir; ~/.influxdbv2/configs dosyasını yalnız hesabınızın okuyabildiğini doğrulayın. Yönetici/operator tokenını uygulamaya veya Grafana’ya vermeyin.
Web arayüzü için kendi bilgisayarınızdan bir tünel açın. sunucu.example.com yerine kendi sunucunuzun doğrulanmış adını kullanın:
ssh -N -L 18086:127.0.0.1:8086 [email protected]Tarayıcınızda http://127.0.0.1:18086 adresini açın. Buradaki yerel HTTP, şifreli SSH tünelinin ucudur; doğrudan sunucunun genel IP adresine HTTP ile token göndermeyin. Ortak/kalıcı erişimde HTTPS ve sınırlı ağ erişimi tasarlayın.
Sınırlı tokenla veri yazın ve okuyun
Arayüzde API Tokens bölümünden yalnız metrics_lab bucket’ına okuma/yazma yetkisi olan özel bir token oluşturun. Ayrı üretici/okuyucu uygulamalarında yazma ve okuma yetkilerini ayrı tokenlara bölün. Tokenı shell geçmişine yazmak yerine etkileşimli alın:
read -rsp 'Token: ' INFLUX_TOKEN
printf '\n'
export INFLUX_TOKEN
export INFLUX_HOST=http://127.0.0.1:8086
influx write --org fibacloud-lab --bucket metrics_lab \
'cpu,host=demo usage_user=12.5'
influx query --org fibacloud-lab \
'from(bucket:"metrics_lab") |> range(start:-15m) |> filter(fn:(r) => r._measurement == "cpu")'
unset INFLUX_TOKENSorguda host=demo, usage_user ve 12.5 değerlerini görmelisiniz. Zaman damgası verilmediği için sunucu yazma anını kullanır; sorgu aralığının bunu kapsaması gerekir. Tokenın başka bucket’a/yönetim işlemine erişemediğini test edin. Yanlış tokenın 401/403 ile reddedilmesini, yanlış bucket veya boş zaman aralığı hatalarıyla karıştırmayın.
Yedekleme, hata giderme ve geri dönüş
2.x yedekleme/geri yükleme belgesine göre uygun yetkili hesapla yedek alın; ayrı instance üzerinde ölçüm ve token yetkilerini doğrulayın. Çalışan veri dizinini sıradan dosya kopyasıyla güvenilir yedek saymayın.
Başlatma sorunu için sudo journalctl -u influxdb -n 80 --no-pager çıktısını, sürümü ve drop-in dosyasını inceleyin. Bu rehberdeki yerel erişim kuralını kaldırmak yerine yanlış port/servis ayarını düzeltin. Başarısız yeni kurulumda servisi durdurup kayıtları koruyun; var olan veri dizinini silmeyin. 2.x’ten 3’e geçiş veya sürüm düşürme ayrı bir veri geçişi çalışmasıdır.
Kaynaklar
- InfluxDB 2.x: imza, paket ve servis kurulumu
- InfluxDB 2.x: ilk kurulum
- InfluxDB 2.x: özel API tokenı
- InfluxDB 2.x: API ile yazma
- InfluxDB 2.x: sorgu çalıştırma
- InfluxDB 2.x: yedekleme ve geri yükleme
Teknik içerik ve kaynaklar 4 Ekim 2026 tarihinde gözden geçirildi. Sürüm veya sağlayıcı değişikliğinde ilgili resmî belgeyi yeniden kontrol edin.
