LOGBREW_PROJECT_ID değişkenine proje UUID’sini yazın. LOGBREW_API_URL
değişkenine https://api.logbrew.co adresini yazın. Örnekler Bash, curl 7.76.0
veya daha yeni bir sürüm ve jq kullanır.
Planlı bir yenilemede eski anahtarı iptal etmeden önce yeni anahtarı oluşturun,
dağıtın ve test edin. Yenileme sıklığını güvenlik politikanızda belirleyin.
Anahtarın bir son kullanma tarihi varsa onu bu tarihten önce değiştirin.
1
Yeni anahtarı oluşturun
POST /api/projects/{project_id}/ingest-keys, en fazla 120 karakterlik
boş olmayan bir label kabul eder. kind değeri cli, sdk, browser,
server veya artifact olur. artifact anahtarı telemetri gönderemez.
İsteğe bağlı expires_at değeri gelecekteki bir RFC3339 zamanı olmalıdır.Eski anahtarla aynı kind değerini kullanın. --kind seçeneğini
vermezseniz CLI sdk kullanır. --label seçeneğini vermezseniz
CLI-created SDK key kullanır. CLI’da son kullanma tarihi için bir seçenek
yoktur. expires_at değerini ayarlamak için API’yi kullanın.CLI, tek seferlik tokenı kaynak kontrolü dışındaki yeni bir dosyaya kaydeder.
Bu dosyayı yalnızca sahibi okuyabilir. CLI tokenı değil, meta verileri
yazdırır:NEW_KEY_ID
değişkenine dönen ingest_key.id değerini yazın.Sonuç belirsizse aynı komutu yeniden çalıştırın. CLI bekleyen yeniden
deneme anahtarını tekrar kullanır. Bu yeniden denemede --abandon-retry
kullanmayın.Doğrudan API istemcisi tokenı yanıtta yalnızca bir kez alır. Yeniden denemek
için aynı gövdeyle aynı Idempotency-Key başlığını gönderin. 24 saat
boyunca bu yeniden deneme aynı anahtarı döndürür. Tokenı asla
yazdırmayın, commit etmeyin veya paylaşmayın.2
Eski anahtar etkinken yeni anahtarı dağıtın
Yeni tokenı korumalı dağıtım ayarına koyun. Uygulamayı dağıtın. Eski
anahtarı etkin tutun. İki tokenı da kaynak koddan, derleme çıktısından ve
loglardan uzak tutun.
3
Tek bir test olayı gönderin
Yeni tokenı Yalnızca okuma bu logu aynı
new_ingest_key kabuk değişkenine aktarın. Tokenı
yazdırmayın. Yeni anahtarla tek bir test logu gönderin, ardından geri
okuyun:occurred_at değeriyle döndürdüğünde devam
edin. Daha eski bir yenileme kontrol logu, yeni anahtarın çalıştığını
kanıtlamaz. Dağıtılan uygulamanın telemetri gönderdiğini de doğrulayın.
Bir komut başarısız olursa durun ve yanıtı okuyun. Açığa çıkmadıysa eski
anahtarı etkin tutun.4
Gizli bilgi içermeyen anahtar meta verilerini listeleyin
LOGBREW_ACCOUNT_BEARER değişkenini hesap kimlik doğrulamanızdan
ayarlayın. Eski anahtarın kimliğini bulun. NEW_KEY_ID anahtarının
active olduğunu doğrulayın:active, expired veya revoked olur. expires_at zamanı geçen anahtar
expired olur.5
Yalnızca eski anahtarı iptal edin
OLD_KEY_ID değişkenini listeden ayarlayın. Komut eski anahtarı yalnızca
iki kimlik farklıysa iptal eder:DELETE idempotent bir işlemdir. Anahtar meta verilerini
status: "revoked" ve dolu bir revoked_at ile döndürür. Belirsiz bir
yanıttan sonra komutu güvenle tekrarlayabilirsiniz.unset new_ingest_key komutunu çalıştırın. Anahtar dosyasını gizli bilgi
politikanıza göre yönetin.Güvenle kurtarın
Yenileme yine başarısız olursa sorun bildirin.
Yalnızca anahtar meta verilerini paylaşın. Kimlik bilgilerini, başlıkları, ham
telemetriyi, müşteri verilerini, yerel yolları veya kaynak kodu eklemeyin.
