Firebase Crashlytics verilerini BigQuery'ye aktarma

Firebase Crashlytics verilerinizi daha ayrıntılı analiz için BigQuery'ye aktarabilirsiniz. BigQuery, verileri BigQuery SQL kullanarak analiz etmenize, başka bir bulut sağlayıcıya aktarmanıza ve Looker Studio ile görselleştirme ve özel kontrol panelleri için kullanmanıza olanak tanır.

Dışa aktarılan verilerle neler yapabilirsiniz?

BigQuery dışa aktarımları, cihaz türü, işletim sistemi, istisnalar (Android uygulamaları) veya hatalar (Apple uygulamaları) ve Crashlytics günlükleri dahil olmak üzere ham kilitlenme verilerinin yanı sıra diğer verileri içerir. Hangi Crashlytics verilerin dışa aktarıldığını ve bunların tablo şemasını bu sayfanın ilerleyen kısımlarında inceleyebilirsiniz.

Dışa aktarılan Crashlytics verilerinizle yapabileceklerinize dair bazı örnekler:

• Sorgu çalıştırma
  Kilitlenme etkinliği verilerini daha kolay anlaşılır özetler halinde toplayan raporlar oluşturmak için Crashlytics verilerinizde sorgu çalıştırabilirsiniz. Bu tür raporlar Crashlytics konsolunun Firebase kontrol panelinde kullanılamadığından, kilitlenme verileriyle ilgili analiz ve anlayışınızı tamamlayabilirler. Bu sayfanın ilerleyen bölümlerinde örnek sorgular bulabilirsiniz.

• Looker Studio şablonu kullanma
  Crashlytics, dışa aktarılan verilerinizi görselleştirmek için önceden oluşturulmuş Looker Studio şablonu sunar.

• Görünüm oluşturma
  BigQuery kullanıcı arayüzünü kullanarak SQL sorgusuyla tanımlanan sanal bir tablo olan görünüm oluşturabilirsiniz. Farklı görünüm türleri ve bunların nasıl oluşturulacağı hakkında ayrıntılı talimatlar için BigQuery dokümanlarına bakın.

• Crashlytics'e özgü verileri Firebase oturum verileriyle birleştirme
  Crashlytics veri aktarımını ayarladığınızda Firebase oturum verilerini de aktarabilirsiniz. Kilitlenme sorunu ile karşılaşmayan kullanıcılar ve kilitlenme sorunu ile karşılaşmayan oturumlar hakkında daha iyi bilgi edinmek için bu oturum verilerini kullanın.

BigQuery için akışı dışa aktarmanın avantajları

Varsayılan olarak veriler, günlük toplu dışa aktarma işlemiyle BigQuery konumuna aktarılır. Ayrıca, BigQuery akışı ile Crashlytics verilerinizi ve Firebase oturumlarınızı gerçek zamanlı olarak yayınlayabilirsiniz. Canlı verilerin gerekli olduğu her amaç için kullanabilirsiniz. Örneğin, bilgileri canlı bir kontrol panelinde sunma, kullanıma sunma sürecini canlı olarak izleme veya uyarıları ve özel iş akışlarını tetikleyen uygulama sorunlarını izleme gibi.

BigQuery'a akış dışa aktarımını etkinleştirdiğinizde toplu tablolara ek olarak anlık tablolar da elde edersiniz. Her iki tablo türü de aynı veri kümesi şemasına sahip olsa da toplu iş tabloları ile gerçek zamanlı tablolar arasında bazı önemli farklılıklar vardır:

Toplu iş tablosu, uzun vadeli analiz ve zaman içindeki trendleri belirlemek için idealdir. Çünkü etkinlikleri yazmadan önce kalıcı olarak saklarız ve 30 güne kadar tabloya geri doldurulabilirler*. Verileri anlık tablonuza yazdığımızda bunları hemen BigQuery konumuna yazarız. Bu nedenle, canlı gösterge tabloları ve özel uyarılar için idealdir. Bu iki tablo, her ikisinin avantajlarından yararlanmak için birleştirme sorgusuyla birleştirilebilir.

Varsayılan olarak, anlık tablo 30 günlük bir bölüm geçerlilik süresine sahiptir. Bunu nasıl değiştireceğinizi öğrenmek için BigQuery dokümanlarındaki Bölümün geçerlilik süresini ayarlama başlıklı makaleyi inceleyin.

^{* Yedek reklam desteğiyle ilgili ayrıntıları Yeni dışa aktarma altyapısına yükseltme başlıklı makalede bulabilirsiniz.}

BigQuery biçimine dışa aktarmayı etkinleştirme

1. Firebase konsolunda Entegrasyonlar sayfasına gidin.

2. BigQuery kartında Bağlantı'yı tıklayın.

3. Aşağıdaki seçenekler de dahil olmak üzere BigQuery'a dışa aktarmayı etkinleştirmek için ekrandaki talimatları uygulayın:

   • Kilitlenme sorunu yaşamayan kullanıcılar ve kilitlenme sorunu yaşamayan oturumlar hakkında daha iyi bilgi edinmek için Firebase oturum verilerini dışa aktarmayı etkinleştirin.

   • Crashlytics verilerinize ve BigQuery'teki Firebase oturum verilerine neredeyse anlık erişim elde etmek için akışla dışa aktarma özelliğini etkinleştirin.

Dışa aktarmayı etkinleştirdiğinizde ne olur?

• Firebase, BigQuery'e bağlı uygulamalardan veri dışa aktarır.

  • Kurulum sırasında, projenizdeki tüm uygulamalar varsayılan olarak BigQuery'ya bağlanır. Ancak kurulum sırasında belirli uygulamaları bağlamamayı seçebilirsiniz.

  • Daha sonra Firebase projenize eklediğiniz tüm uygulamalar otomatik olarak BigQuery'ya bağlanır.

  • Dilediğiniz zaman hangi uygulamaların veri dışa aktaracağını yönetebilirsiniz.

• Firebase, verileri kurulum sırasında seçtiğiniz veri kümesi konumuna aktarır.

  • Bu konum hem Crashlytics veri kümesi hem de Firebase oturumları veri kümesi (oturum verilerinin dışa aktarılması etkinleştirilmişse) için geçerlidir.

  • Bu konum yalnızca BigQuery'ya aktarılan veriler için geçerlidir ve Firebase konsolunun Crashlytics kontrol panelinde veya Android Studio'da kullanılmak üzere depolanan verilerin konumunu etkilemez.

  • Veri kümesi oluşturulduktan sonra konumu değiştirilemez ancak veri kümesini farklı bir konuma kopyalayabilir veya veri kümesini farklı bir konuma manuel olarak taşıyabilirsiniz (yeniden oluşturma). Daha fazla bilgi için Mevcut dışa aktarma işlemlerinin konumunu değiştirme başlıklı makaleyi inceleyin.

• Firebase, toplu verilerinizin BigQuery ile günlük olarak senkronize edilmesini sağlar.

  • BigQuery'ya bağlandıktan sonra ilk toplu veri dışa aktarma işlemi 48 saati bulabilir.

  • Günlük senkronizasyon, BigQuery'da ayarlamış olabileceğiniz planlanmış dışa aktarma işlemlerinden bağımsız olarak günde bir kez gerçekleşir. Senkronizasyon işinin zamanlaması ve süresinin değişebileceğini unutmayın. Bu nedenle, dışa aktarma işleminin belirli bir zamanlamasına göre sonraki işlemlerin veya işlerin planlanmasını önermiyoruz.

• Firebase mevcut verilerinizin bir kopyasını dışa aktararak BigQuery'e aktarır.

  • Bu dışa aktarma işlemi, her bağlı uygulama için günlük senkronizasyondan elde edilen verileri içeren bir toplu tablo içerir.

  • Toplu iş tablosu için manuel olarak veri geri doldurma işlemleri planlayabilirsiniz. Bu işlemler, BigQuery'e dışa aktarmayı etkinleştirdiğinizde son 30 güne kadar veya en son tarih için (hangisi daha yakınsa) planlanabilir.

  Ekim 2024'ün ortasından önce Crashlytics verilerinin dışa aktarılmasını etkinleştirdiyseniz dışa aktarmayı etkinleştirdiğiniz günden önceki 30 günü de doldurabileceğinizi unutmayın.

• Akışı BigQuery'a dışa aktarmayı etkinleştirirseniz aşağıdaki koşullar geçerlidir.

  • Ayrıca, her bağlı uygulamanın sürekli güncellenen verileri içeren kendi gerçek zamanlı tablosu (uygulamanın günlük toplu dışa aktarma için toplu tablosuna ek olarak) olacaktır.

  • Yayın etkinleştirildikten sonra verilerin yayınlanmaya başlaması 1 saati bulabilir.

  Anlık tabloya veri gelmiyor mu?

  1. Uygulamanızdan Crashlytics adresine en az iki etkinlik gönderdiğinizden ve gönderdikten sonra birkaç dakika beklediğinizden emin olun.

  2. Firebase projenizin kullandıkça öde Blaze fiyatlandırma planında olduğundan emin olun.
     Bunu, Firebase konsolunun sol alt köşesine bakarak kontrol edebilirsiniz.

  3. İki etkinlik gönderip birkaç dakika bekledikten sonra anlık tablonuzda hâlâ veri yoksa:

     1. Firebase konsolunda BigQuery kartına gidin.

     2. Akış dışa aktarma özelliğini devre dışı bırakıp yeniden etkinleştirin.

     3. Hizmet hesabının service-PROJECT_NUMBER@gcp-sa-crashlytics.iam.gserviceaccount.com Firebase projenizde olduğundan ve Firebase Crashlytics Hizmet Aracısı rolüne sahip olduğundan emin olun.
        Bunu Google Cloud konsolunun IAM sayfasında kontrol edebilirsiniz (Google tarafından sağlanan rol izinlerini ekle onay kutusunu işaretlediğinizden emin olun).

     4. Crashlytics adresine en az iki etkinlik gönderin ve birkaç dakika bekleyin.

  4. Gerçek zamanlı tablonuzda hâlâ veri görmüyorsanız Firebase Destek Ekibi ile iletişime geçin.

Örnek sorgular

1. örnek: Firebase oturum verilerini kullanarak kilitlenme sorunu ile karşılaşmayan kullanıcılarla ilgili metrikleri hesaplama

En son sürümünüzde, kritik bir kullanıcı yolculuğundaki kilitlenmeleri gidermek için uygulamanızda büyük bir yenileme yaptınız. Kullanıcılardan mükemmel yorumlar aldınız ancak uygulamanızın eskisinden daha kararlı olduğuna dair nicel kanıtlar istiyorsunuz.

Kilitlenme içermeyen metrikler bu bilgileri sağlamaya yardımcı olabilir. Bu metrikler, uygulamanızın genel durumunu anlamanıza yardımcı olan önemli ölçümlerdir. Firebase oturum verileri ve Crashlytics etkinlikleriyle bu metrikleri temel bir sorguyla hesaplayabilirsiniz.

Android uygulaması için örnek sorgular aşağıda verilmiştir. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

Belirli bir sürümde kilitlenme sorunu yaşamayan kullanıcılar:

SELECT
  TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY) AS event_date,
  (1 - (COUNT (DISTINCT installation_uuid) / COUNT (DISTINCT instance_id))) AS CFU
FROM
  `PROJECT_ID.firebase_sessions.PACKAGE_NAME_ANDROID` AS sessions
LEFT JOIN
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID` AS crashlytics
ON
  TIMESTAMP_TRUNC(_PARTITIONTIME,DAY) = TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY)
WHERE
  crashlytics.error_type="FATAL"
  AND crashlytics.application.display_version="APP_VERSION"
  AND sessions.application.display_version = "APP_VERSION"
GROUP BY
  event_date
ORDER BY
  event_date

Geçen hafta (son 168 saat) boyunca kilitlenme sorunu yaşanmayan oturum sayısı:

SELECT
  TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY) AS event_date,
  (1 - (COUNT (DISTINCT crashlytics.event_id) / COUNT (DISTINCT sessions.session_id))) AS CFS
FROM
  `PROJECT_ID.firebase_sessions.PACKAGE_NAME_ANDROID` AS sessions
LEFT JOIN
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID` AS crashlytics
ON
  TIMESTAMP_TRUNC(_PARTITIONTIME,DAY) = TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY)
WHERE
  crashlytics.error_type="FATAL" AND _PARTITIONTIME >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 168 HOUR)
  AND _PARTITIONTIME < CURRENT_TIMESTAMP()
GROUP BY
  event_date
ORDER BY
  event_date

2. örnek: Günlük kilitlenme sayısı

Mümkün olduğunca çok sayıda hatayı düzeltmek için çalıştıktan sonra ekibinizin nihayet yeni fotoğraf paylaşım uygulamanızı kullanıma sunmaya hazır olduğunu düşünüyorsunuz. Ancak bunu yapmadan önce, hata avı etkinliğinizin uygulamayı zaman içinde daha kararlı hale getirdiğinden emin olmak için son bir ayda günlük kilitlenme sayısını kontrol etmek istiyorsunuz.

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT
  COUNT(DISTINCT event_id) AS number_of_crashes,
  FORMAT_TIMESTAMP("%F", event_timestamp) AS date_of_crashes
FROM
 `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
GROUP BY
  date_of_crashes
ORDER BY
  date_of_crashes DESC
LIMIT 30;

3. örnek: En yaygın kilitlenmeleri bulma

Üretim planlarına doğru şekilde öncelik vermek için uygulamanızdaki en yaygın 10 kilitlenmeyi bulmak istiyorsunuz. İlgili veri noktalarını sağlayan bir sorgu oluşturuyorsunuz.

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT
  DISTINCT issue_id,
  COUNT(DISTINCT event_id) AS number_of_crashes,
  COUNT(DISTINCT installation_uuid) AS number_of_impacted_user,
  blame_frame.file,
  blame_frame.line
FROM
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
  event_timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(),INTERVAL 168 HOUR)
  AND event_timestamp < CURRENT_TIMESTAMP()
GROUP BY
  issue_id,
  blame_frame.file,
  blame_frame.line
ORDER BY
  number_of_crashes DESC
LIMIT 10;

4. örnek: En çok kilitlenen 10 cihaz

Sonbahar, yeni telefon sezonu! Şirketiniz, bu durumun özellikle Android'de yeni cihaza özgü sorunların yaşanabileceği bir dönem olduğunu da biliyor. Yaklaşan uyumluluk sorunlarını önlemek için geçen hafta (168 saat) en çok kilitlenen 10 cihazı belirleyen bir sorgu oluşturdunuz.

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT
  device.model,
COUNT(DISTINCT event_id) AS number_of_crashes
FROM
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
  event_timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 168 HOUR)
  AND event_timestamp < CURRENT_TIMESTAMP()
GROUP BY
  device.model
ORDER BY
  number_of_crashes DESC
LIMIT 10;

5. örnek: Özel anahtara göre filtreleme

Oyununuzun hangi seviyesinde en çok kilitlenme yaşandığını öğrenmek isteyen bir oyun geliştiricisiniz.

Bu istatistiği izlemeye yardımcı olması için current_level adlı bir özel Crashlytics anahtarı ayarlarsınız ve kullanıcı yeni bir seviyeye ulaştığında bu anahtarı güncellersiniz.

Crashlytics.sharedInstance().setIntValue(3, forKey: "current_level");

CrashlyticsKit setIntValue:3 forKey:@"current_level";

Crashlytics.setInt("current_level", 3);

Dışa aktarma işleminizde bu anahtarı kullanarak BigQuery, her kilitlenme etkinliğiyle ilişkili current_level değerlerinin dağılımını bildiren bir sorgu yazabilirsiniz.

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT
COUNT(DISTINCT event_id) AS num_of_crashes,
  value
FROM
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
UNNEST(custom_keys)
WHERE
  key = "current_level"
GROUP BY
  key,
  value
ORDER BY
  num_of_crashes DESC

6. örnek: User-ID'yi ayıklama

Erken erişim aşamasında olan bir Android uygulamanız var. Kullanıcılarınızın çoğu bu sürümü beğeniyor ancak üç kullanıcı, alışılmadık sayıda kilitlenme sorunu yaşıyor. Sorunun kaynağını bulmak için bu kullanıcıların kullanıcı kimliklerini kullanarak bu kullanıcılarla ilgili tüm kilitlenme etkinliklerini çeken bir sorgu yazarsınız.

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT *
FROM
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
  user.id IN ("USER_ID_1", "USER_ID_2", "USER_ID_3")
ORDER BY
  user.id
 

7. örnek: Belirli bir kilitlenme sorunuyla karşılaşan tüm kullanıcıları bulma

Ekibiniz, beta test kullanıcılarından oluşan bir gruba yanlışlıkla kritik bir hata içeren sürüm yayınladı. Ekibiniz, yukarıdaki "En yaygın kilitlenmeleri bulma" örneğindeki sorguyu kullanarak belirli kilitlenme sorunu kimliğini belirleyebildi. Şimdi ekibiniz, bu kilitlenmeden etkilenen uygulama kullanıcılarının listesini çıkarmak için bir sorgu çalıştırmak istiyor.

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT user.id as user_id
FROM
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
  issue_id = "ISSUE_ID"
  AND application.display_version = "APP_VERSION"
  AND user.id != ""
ORDER BY
  user.id;

8. örnek: Kilitlenme sorunundan etkilenen kullanıcı sayısı (ülkeye göre ayrılmış)

Ekibiniz, yeni bir sürümün kullanıma sunulması sırasında kritik bir hata tespit etti. Yukarıdaki "En yaygın kilitlenmeleri bulma" örneğindeki sorguyu kullanarak belirli kilitlenme sorunu kimliğini belirleyebildiniz. Ekibiniz, bu kilitlenmenin dünyanın farklı ülkelerindeki kullanıcılara yayılıp yayılmadığını görmek istiyor.

Bu sorguyu yazmak için ekibinizin aşağıdakileri yapması gerekir:

1. Google Analytics verilerinin BigQuery'ye aktarılmasını etkinleştirin. Proje verilerini BigQuery'ye aktarma başlıklı makaleyi inceleyin.

2. Uygulamanızı, hem Google Analytics SDK'sına hem de Crashlytics SDK'sına kullanıcı kimliği iletecek şekilde güncelleyin.

   Swift

   Crashlytics.sharedInstance().setUserIdentifier("123456789");
   Analytics.setUserID("123456789");
   

   Objective-C

   CrashlyticsKit setUserIdentifier:@"123456789";
   FIRAnalytics setUserID:@"12345678 9";
   

   Java

   Crashlytics.setUserIdentifier("123456789");
   mFirebaseAnalytics.setUserId("123456789");
   

3. Google Analytics veri kümesindeki etkinlikleri Crashlytics veri kümesindeki kilitlenmelerle birleştirmek için kullanıcı kimliği alanını kullanan bir sorgu yazın.

   Android uygulaması için örnek sorgu aşağıda verilmiştir. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

   SELECT DISTINCT c.issue_id, a.geo.country, COUNT(DISTINCT c.user.id) as num_users_impacted
   FROM `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID` c
   INNER JOIN  `PROJECT_ID.analytics_TABLE_NAME.events_*` a on c.user.id = a.user_id
   WHERE
     c.issue_id = "ISSUE_ID"
     AND a._TABLE_SUFFIX BETWEEN '20190101'
     AND '20200101'
   GROUP BY
     c.issue_id,
     a.geo.country,
     c.user.id

9. örnek: Bugün şu ana kadar karşılaşılan en büyük 5 sorun

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT
  issue_id,
  COUNT(DISTINCT event_id) AS events
FROM
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID_REALTIME`
WHERE
  DATE(event_timestamp) = CURRENT_DATE()
GROUP BY
  issue_id
ORDER BY
  events DESC
LIMIT
  5;

10. örnek: Bugün dahil olmak üzere, TARİH'ten bu yana en önemli 5 sorun

Güvenilir toplu verilerinize gerçek zamanlı bilgiler eklemek için toplu ve gerçek zamanlı tabloları birleştirme sorgusuyla da birleştirebilirsiniz. event_id birincil anahtar olduğundan, iki tablodaki ortak etkinlikleri tekilleştirmek için DISTINCT event_id kullanabilirsiniz.

Android uygulaması için örnek sorguyu aşağıda bulabilirsiniz. iOS uygulaması için paket adı ve ANDROID yerine paket kimliğini ve IOS kullanın.

SELECT
  issue_id,
  COUNT(DISTINCT event_id) AS events
FROM (
  SELECT
    issue_id,
    event_id,
    event_timestamp
  FROM
    `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID_REALTIME`
  UNION ALL
  SELECT
    issue_id,
    event_id,
    event_timestamp
  FROM
    `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`)
WHERE
  event_timestamp >= PARSE_TIMESTAMP("%Y_%m_%d", "YYYY_MM_DD")
GROUP BY
  issue_id
ORDER BY
  events DESC
LIMIT
  5;

Dışa aktarılan Crashlytics verilerini Looker Studio ile görselleştirme

Looker Studio BigQuery içindeki Crashlytics veri kümelerinizi okunması ve paylaşılması kolay, tamamen özelleştirilebilen raporlara dönüştürür.

Looker Studio kullanımı hakkında daha fazla bilgi edinmek için karşılama rehberine göz atın.

Crashlytics rapor şablonu kullanma

Looker Studio, dışa aktarılan Crashlytics BigQuery şemasından kapsamlı bir boyut ve metrik grubu içeren Crashlytics için örnek bir rapora sahiptir. Crashlytics'e BigQuery akışlı dışa aktarma özelliğini etkinleştirdiyseniz bu verileri Looker Studio şablonunun Anlık trendler sayfasında görüntüleyebilirsiniz.Örnekleri, kendi uygulamanızın ham kilitlenme verilerine dayalı olarak hızlı bir şekilde yeni raporlar ve görselleştirmeler oluşturmak için şablon olarak kullanabilirsiniz:

1. Crashlytics Looker Studio Kontrol paneli şablonunu açın.

2. Sağ üst köşedeki Şablonu Kullan'ı tıklayın.

3. Yeni Veri Kaynağı açılır listesinde Yeni Veri Kaynağı Oluştur'u seçin.

4. BigQuery kartında Seç'i tıklayın.

5. Projelerim > PROJECT_ID > firebase_crashlytics > TABLE_NAME'i seçerek dışa aktarılan Crashlytics verilerini içeren bir tablo seçin.

   Toplu işlem tablonuz her zaman seçilebilir. Crashlytics BigQuery için akış dışa aktarma etkinleştirildiyse bunun yerine gerçek zamanlı tablonuzu seçebilirsiniz.

6. Yapılandırma bölümünde Crashlytics Şablon düzeyi'ni Varsayılan olarak ayarlayın.

7. Yeni veri kaynağını oluşturmak için Bağlan'ı tıklayın.

8. Crashlytics şablonuna dönmek için Rapora Ekle'yi tıklayın.

9. Son olarak, Crashlytics Looker Studio gösterge tablosu şablonunun kopyasını oluşturmak için Rapor Oluştur'u tıklayın.

BigQuery şemasını anlama

Firebase, dışa aktarılan verileriniz için BigQuery içinde yeni veri kümeleri oluşturur:

• Crashlytics dataset

• Firebase oturumları veri kümesi (oturum verilerinin dışa aktarılması etkinse)

Crashlytics veri kümesi

Crashlytics verileri, firebase_crashlytics adlı BigQuery veri kümesine aktarılır. Veri kümesi, birden fazla uygulama içerse bile projenizin tamamını kapsar.

Tablolar

Varsayılan olarak Firebase, Crashlytics veri kümesinde BigQuery'ye bağlı projenizdeki her uygulama için ayrı tablolar oluşturur.

Tablolar, uygulamanın tanımlayıcısına göre adlandırılır (noktalar alt çizgiye dönüştürülür) ve uygulamanın platformu (_IOS veya _ANDROID) eklenir. Örneğin, paket adı com.google.test olan bir Android uygulamasına ait veriler com_google_test_ANDROID adlı tabloda yer alır.

• BigQuery konumuna akış dışa aktarma etkinleştirildiyse veriler, _REALTIME ile eklenmiş bir tabloya da anlık olarak aktarılır (örneğin, com_google_test_ANDROID_REALTIME).

• Tablodaki her satır, uygulamada meydana gelen bir etkinliği (kilitlenmeler, onarılabilir hatalar ve ANR'ler dahil) temsil eder.

• Tablolar, uygulamanızda tanımladığınız özel Crashlytics anahtarların yanı sıra standart bir Crashlytics veri kümesi içerir.

Satırlar

Tablodaki her satır, uygulamanın karşılaştığı bir hatayı temsil eder.

Sütunlar

Bir tablodaki sütunlar kilitlenmeler, onarılabilir hatalar ve ANR'ler için aynıdır.

• BigQuery için akış dışa aktarma etkinleştirilirse gerçek zamanlı tablo, toplu tabloyla aynı sütunlara sahip olur.

• Etkinlikleri temsil eden satırlarda yığın izleri olmayan sütunlar olabilir.

Dışa aktarılan Crashlytics verileri için tablodaki sütunlar şunlardır:

Firebase oturumları veri kümesi

Firebase oturum verileri, BigQuery adlı bir veri kümesine aktarılır firebase_sessions. Veri kümesi, birden fazla uygulama içerse bile projenizin tamamını kapsar.

Tablolar

Varsayılan olarak Firebase, projenizde BigQuery'e bağlı her uygulama için Firebase oturumları veri kümesinde ayrı tablolar oluşturur.

Tablolar, uygulamanın tanımlayıcısına göre adlandırılır (noktalar alt çizgiye dönüştürülür) ve uygulamanın platformu (_IOS veya _ANDROID) eklenir. Örneğin, paket adı com.google.test olan bir Android uygulamasına ait veriler com_google_test_ANDROID adlı tabloda yer alır.

Satırlar

Tablodaki her satır, gerçekleşen bir oturum etkinliğini temsil eder.

Sütunlar

BigQuery için akış dışa aktarma etkinleştirilirse gerçek zamanlı tablo, toplu tabloyla aynı sütunlara sahip olur.

Dışa aktarılan Firebase oturum verilerinin tablosundaki sütunlar şunlardır:

Yeni dışa aktarma altyapısına yükseltme

Crashlytics, Ekim 2024'ün ortalarında Crashlytics verilerinin BigQuery'ye toplu dışa aktarımı için yeni bir altyapı kullanıma sundu.

Tüm Firebase projeleri, 15 Eylül 2025'ten itibaren yeni toplu dışa aktarma altyapısına otomatik olarak yükseltilecek. Bu tarihten önce yükseltme yapabilirsiniz ancak BigQuery toplu tablolarınızın yükseltme için ön koşulları karşıladığından emin olun.

Yeni altyapıya geçebilirsiniz ancak BigQuery toplu tablolarınızın yükseltme için ön koşulları karşıladığından emin olun.

Yeni altyapıda olup olmadığınızı belirleme

Toplu dışa aktarma özelliğini Ekim 2024'ün ortasında veya daha sonra etkinleştirdiyseniz Firebase projeniz yeni dışa aktarma altyapısını otomatik olarak kullanır.

Projenizin hangi altyapıyı kullandığını kontrol edebilirsiniz: Google Cloud konsoluna gidin. "Veri aktarımı yapılandırmanız" Firebase Crashlytics with Multi-Region Support olarak etiketlenmişse projeniz yeni dışa aktarma altyapısını kullanıyor demektir.

Eski ve yeni dışa aktarma altyapısı arasındaki önemli farklar

• Yeni altyapı, Crashlytics veri kümesi konumlarını destekler.

  • Ekim 2024'ün ortalarından önce dışa aktarma etkinleştirildi ve yeni dışa aktarma altyapısına yükseltildi: Artık isteğe bağlı olarak veri dışa aktarma konumunu değiştirebilirsiniz.

  • Dışa aktarma, Ekim 2024'ün ortasında veya daha sonra etkinleştirildi: Kurulum sırasında veri dışa aktarma için bir konum seçmeniz istendi.

• Yeni altyapı, dışa aktarmayı etkinleştirmeden önceki verilerin geri doldurulmasını desteklemez.

  • Eski altyapı, dışa aktarmayı etkinleştirdiğiniz tarihten önceki 30 güne kadar geri doldurmayı destekliyordu.

  • Yeni altyapı, son 30 güne kadar doldurma işlemlerini veya dışa aktarmayı etkinleştirdiğiniz en son tarihi (hangisi daha yakınsa) destekler.BigQuery

• Yeni altyapı, Firebase projenizdeki Firebase uygulamalarınız için ayarlanan tanımlayıcıları kullanarak BigQuery toplu tablolar oluşturur.

  • Eski altyapı, verileri uygulamanızın ikilisindeki paket kimliklerine veya paket adlarına göre adlandırılmış toplu iş tablolarına yazıyordu.

  • Yeni altyapı, verileri Firebase projenizde kayıtlı Firebase uygulamalarınız için ayarlanan paket kimliklerine veya paket adlarına göre adlandırılmış toplu iş tablolarına yazar.

1. adım: Yükseltme için ön koşul

1. Mevcut BigQuery toplu tablolarınızın, Firebase projenizde kayıtlı Firebase uygulamalarınız için ayarlanan paket kimlikleri veya paket adlarıyla eşleşen tanımlayıcılar kullandığını kontrol edin. Eşleşmezlerse dışa aktarılan toplu verilerinizde kesintiler yaşayabilirsiniz. Çoğu proje uygun ve uyumlu durumda olur ancak yükseltme yapmadan önce kontrol etmeniz önemlidir.

   • Firebase projenize kaydedilen tüm Firebase uygulamalarını Firebase konsolunda bulabilirsiniz: settings Proje ayarları'na gidin, ardından tüm Firebase uygulamalarınızı ve bilgilerini görmek için Uygulamalarınız kartına gidin.

   • Tüm BigQuery toplu tablolarınızı Google Cloud konsolunun BigQuery sayfasında bulabilirsiniz.

   Örneğin, yükseltme sırasında sorun yaşamayacağınız ideal durumlar şunlardır:

   • com_yourcompany_yourproject_IOS adlı bir toplu iş tablonuz ve Firebase projenize kaydedilmiş com.yourcompany.yourproject paket kimliğine sahip bir Firebase iOS+ uygulamanız var.

   • com_yourcompany_yourproject_ANDROID adlı bir toplu iş tablonuz ve Firebase projenize kaydedilmiş com.yourcompany.yourproject paket adına sahip bir Firebase Android uygulamanız var.

2. Kayıtlı Firebase uygulamalarınız için ayarlanan tanımlayıcılarla eşleşmeyen toplu tablo adlarınız varsa toplu dışa aktarma işleminizin kesintiye uğramaması için bu sayfadaki talimatları manuel olarak yükseltmeden veya 15 Eylül 2025'ten önce uygulayın.

2. adım: Yeni altyapıya manuel olarak geçin

Toplu dışa aktarma özelliğini Ekim 2024'ün ortasından önce etkinleştirdiyseniz Crashlytics veri dışa aktarma özelliğini Firebase konsolunda kapatıp tekrar açarak yeni altyapıya manuel olarak yükseltebilirsiniz.

Ayrıntılı adımlar aşağıda verilmiştir:

1. Firebase konsolunda Entegrasyonlar sayfasına gidin.

2. BigQuery kartında Yönet'i tıklayın.

3. Dışa aktarmayı devre dışı bırakmak için Crashlytics kaydırma çubuğunu kapatın. İstendiğinde veri dışa aktarma işlemini durdurmak istediğinizi onaylayın.

4. Dışa aktarmayı yeniden etkinleştirmek için Crashlytics kaydırma çubuğunu hemen tekrar açın. İstendiğinde verileri dışa aktarmak istediğinizi onaylayın.

   Crashlytics verilerinizin BigQuery konumuna dışa aktarılması artık yeni dışa aktarma altyapısı kullanılarak yapılıyor.

Mevcut toplu tablo adınız, Firebase uygulama tanımlayıcınızla eşleşmiyor