مخطط السجلّ للبيانات التي تم تصديرها في Cloud Logging

تقدّم هذه الصفحة مخطط السجلّ لبيانات Crashlytics التي تم تصديرها وبيانات جلسات Firebase في Cloud Logging.


Crashlytics مخطط

Event

الرسالة التي تصف حدثًا واحدًا من أحداث Crashlytics

تمثيل JSON

{
  "name": string,
  "platform": string,
  "bundleOrPackage": string,
  "eventId": string,
  "sessionId": string,
  "eventTime": string,
  "receivedTime": string,
  "issue": {
    object (Issue)
  },
  "issueVariant": {
    object (IssueVariant)
  },
  "device": {
    object (Device)
  },
  "memory": {
    object (Memory)
  },
  "storage": {
    object (Storage)
  },
  "operatingSystem": {
    object (OperatingSystem)
  },
  "browser": {
    object (Browser)
  },
  "version": {
    object (Version)
  },
  "user": {
    object (User)
  },
  "customKeys": {
    string: string,
    ...
  },
  "installationUuid": string,
  "crashlyticsSdkVersion": string,
  "appOrientation": string,
  "deviceOrientation": string,
  "logs": [
    {
      object (Log)
    }
  ],
  "breadcrumbs": [
    {
      object (Breadcrumb)
    }
  ],
  "blameFrame": {
    object (Frame)
  },
  "exceptions": [
    {
      object (Exception)
    }
  ],
  "errors": [
    {
      object (Error)
    }
  ],
  "threads": [
    {
      object (Thread)
    }
  ],
  "processState": string,
  "issueTitle": string,
  "issueSubtitle": string,
  "buildStamp": string
}
الحقول الوصف
name string

مطلوبة النتائج فقط غير قابل للتغيير: المعرّف: تمثّل هذه السمة اسم مورد الحدث. التنسيق: projects/{project}/apps/{app_id}/events/{event}
platform string

النظام الأساسي للأجهزة الجوّالة (Android أو iOS)
bundleOrPackage string

اسم الحزمة لتطبيقات iOS أو اسم حزمة تطبيقات Android التنسيق: com.mycompany.myapp
eventId string

النتائج فقط غير قابل للتغيير: يتم تعيين معرّف الحدث الفريد أثناء المعالجة.
sessionId string

المعرّف الفريد لجلسة Firebase.
eventTime string (Timestamp format)

الطابع الزمني للجهاز الذي تم تسجيل الحدث فيه

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
receivedTime string (Timestamp format)

الطابع الزمني للخادم الذي تلقّى فيه Crashlytics الحدث.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
issue object (Issue)

تفاصيل [المشكلة] المعيّنة لهذا [الحدث].
issueVariant object (IssueVariant)

تفاصيل [IssueVariant] المُعيَّن لهذا [Event].
device object (Device)

البيانات الوصفية للأجهزة الجوّالة
memory object (Memory)

استخدام ذاكرة الجهاز الجوّال
storage object (Storage)

استخدام القرص/ذاكرة الفلاش على الجهاز الجوّال
operatingSystem object (OperatingSystem)

نظام التشغيل والإصدار.
browser object (Browser)

المتصفح والإصدار
version object (Version)

إصدار تطبيق الأجهزة الجوّالة
user object (User)

معرّفات المستخدم النهائي لمالك الجهاز
customKeys map (key: string, value: string)

المفاتيح المخصّصة التي يضبطها المطوّر أثناء الجلسة

عنصر يحتوي على قائمة بأزواج "المفتاح": القيمة. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
installationUuid string

المعرّف الفريد لعملية تثبيت التطبيق على الجهاز يُستخدَم هذا الحقل لاحتساب العدد الفريد من المستخدمين المتأثرين.
crashlyticsSdkVersion string

إصدار حزمة تطوير البرامج (SDK) في Crashlytics
appOrientation string

اتجاه التطبيق عند حدوث العطل (عمودي أو أفقي)
deviceOrientation string

اتجاه الجهاز في وقت التعطُّل (عمودي أو أفقي)
logs[] object (Log)

رسائل السجلّ التي سجّلها المطوّر أثناء الجلسة
breadcrumbs[] object (Breadcrumb)

أحداث "إحصاءات Google" التي تسجّلها حزمة تطوير البرامج (SDK) الخاصة بخدمة "إحصاءات Google" أثناء الجلسة
blameFrame object (Frame)

إطار تتبُّع تسلسل استدعاء الدوال البرمجية الذي أبلغت عنه عملية معالجة Crashlytics. وقد لا تكون متاحة في أداة التحليل المستقبلية.
exceptions[] object (Exception)

على أجهزة Android فقط الاستثناءات التي حدثت أثناء هذا الحدث يتم عرض الاستثناءات المتداخلة بترتيب زمني عكسي، بحيث يكون السجلّ الأخير هو الاستثناء الأول الذي تم طرحه.
errors[] object (Error)

على أجهزة Apple فقط خطأ غير خطير تم رصده بواسطة حزمة تطوير البرامج (SDK) لنظام التشغيل iOS وتتبُّع تسلسل استدعاء الدوال البرمجية الخاص به
threads[] object (Thread)

سلاسل التطبيق المتوفّرة في وقت تسجيل الحدث يحتوي كلّ منها على تتبُّع تسلسل استدعاء الدوال البرمجية. سيتم إلقاء اللوم على سلسلة محادثات واحدة بشأن الخطأ.
processState string

تمثّل هذه السمة حالة عملية التطبيق في وقت وقوع الحدث.
issueTitle string

تمثّل هذه السمة عنوان المشكلة التي تم تجميع الحدث فيها. ويكون هذا عادةً اسم ملف مصدر أو اسم طريقة.
issueSubtitle string

تمثّل هذه السمة العنوان الفرعي للمشكلة التي تم تجميع الحدث فيها. ويكون هذا عادةً رمزًا أو رسالة استثناء.
buildStamp string

البيانات الوصفية التي يوفّرها نظام إنشاء التطبيق، بما في ذلك معلومات مستودع التحكّم في الإصدار.

Memory

استخدام ذاكرة الجهاز الجوّال

تمثيل JSON

{
  "used": string,
  "free": string
}
الحقول الوصف
used string (int64 format)

وحدات البايت المستخدَمة
free string (int64 format)

وحدات البايت المتاحة

Storage

استخدام القرص/ذاكرة الفلاش على الجهاز الجوّال لا يتم تسجيلها على جميع الأجهزة.

تمثيل JSON

{
  "used": string,
  "free": string
}
الحقول الوصف
used string (int64 format)

وحدات البايت المستخدَمة
free string (int64 format)

وحدات البايت المتاحة

User

معرّفات المستخدمين المقدَّمة من المطوّرين

تمثيل JSON

{
  "id": string
}
الحقول الوصف
id string

رقم تعريف المستخدم إذا قدّمه مطوّر التطبيق

Frame

إطار في تتبُّع تسلسل استدعاء الدوال البرمجية

تمثيل JSON

{
  "line": string,
  "file": string,
  "symbol": string,
  "offset": string,
  "address": string,
  "library": string,
  "owner": string,
  "blamed": boolean
}
الحقول الوصف
line string (int64 format)

رقم السطر في ملف الإطار.
file string

اسم ملف المصدر الذي تم العثور على الإطار فيه
symbol string

رمز الإطار بعد إزالة التشويش أو الترميز الرمز الأولي من الجهاز إذا تعذّر ترطيبه.
offset string (int64 format)

إزاحة البايت في الصورة الثنائية التي تحتوي على الرمز تمثّل هذه السمة إطارًا أصليًا.
address string (int64 format)

عنوان الصورة الثنائية التي تحتوي على الرمز. تمثّل هذه السمة العرض التقديمي للإطارات الأصلية.
library string

الاسم المعروض للمكتبة التي تتضمّن الإطار
owner string

يجب أن تكون إحدى القيم التالية: DEVELOPER أو VENDOR أو RUNTIME أو PLATFORM أو SYSTEM.
blamed boolean

تكون القيمة صحيحة عندما يحدّد تحليل Crashlytics أنّ هذا الإطار من المحتمل أن يكون سبب الخطأ.

Exception

خطأ Java واستدعاء الدوال البرمجية، وذلك من تطبيقات Android فقط

تمثيل JSON

{
  "type": string,
  "exceptionMessage": string,
  "nested": boolean,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
الحقول الوصف
type string

نوع الاستثناء، مثل java.lang.IllegalStateException.
exceptionMessage string

رسالة مرتبطة بالاستثناء
nested boolean

تكون القيمة "صحيح" لجميع الاستثناءات التي تم طرحها باستثناء الاستثناء الأخير (أي السجلّ الأول).
title string

تمثّل هذه السمة عنوان الاستثناء.
subtitle string

تمثّل هذه السمة العنوان الفرعي للاستثناء.
blamed boolean

تكون القيمة صحيحة عندما يحدّد تحليل Crashlytics أنّ هذا الثريد هو المكان الذي حدث فيه الخطأ.
frames[] object (Frame)

الإطارات في تتبُّع تسلسل استدعاء الدوال البرمجية للاستثناء.

Error

خطأ غير خطير وتتبُّع تسلسل استدعاء الدوال البرمجية، من تطبيقات Apple فقط

تمثيل JSON

{
  "queue": string,
  "code": string,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
الحقول الوصف
queue string

قائمة الانتظار التي كان يتم تشغيل سلسلة المحادثات عليها
code string (int64 format)

رمز الخطأ المرتبط بـ NSError المخصّص الذي سجّله التطبيق
title string

تمثّل هذه السمة عنوان الخطأ.
subtitle string

العنوان الفرعي للخطأ
blamed boolean

تكون القيمة صحيحة عندما يحدّد تحليل Crashlytics أنّ موضع الخطأ هو تتبُّع تسلسل استدعاء الدوال البرمجية في هذا الخطأ.
frames[] object (Frame)

إطارات تتبُّع تسلسل استدعاء الدوال البرمجية في الخطأ

Thread

سلسلة تعليمات برمجية في تطبيق

JSON representation</code></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>{
  "crashed": boolean,
  "name": string,
  "queue": string,
  "signal": string,
  "signalCode": string,
  "crashAddress": string,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ],
  "threadId": string,
  "sysThreadId": string,
  "threadState": enum (State)
}
الحقول الوصف
crashed boolean

تكون القيمة True عندما تعطلت سلسلة المحادثات.
name string

اسم سلسلة المحادثات
queue string

قائمة الانتظار التي كان يتم تشغيل سلسلة المحادثات عليها
signal string

اسم الإشارة التي أدّت إلى تعطُّل التطبيق يظهر هذا الحقل فقط في سلاسل التعليمات البرمجية الأصلية التي تعذّر إكمالها.
signalCode string

رمز الإشارة التي أدّت إلى تعطُّل التطبيق يظهر هذا الحقل فقط في سلاسل التعليمات البرمجية الأصلية التي تعذّر إكمالها.
crashAddress string (int64 format)

عنوان الإشارة التي تسبّبت في تعطُّل التطبيق يظهر هذا الحقل فقط في سلاسل التعليمات البرمجية الأصلية التي تعذّر تشغيلها.
title string

تمثّل هذه السمة عنوان سلسلة المحادثات.
subtitle string

تمثّل هذه السمة العنوان الفرعي لسلسلة المحادثات.
blamed boolean

تكون القيمة صحيحة عندما يحدّد تحليل Crashlytics أنّ تتبُّع تسلسل استدعاء الدوال البرمجية في هذا الموضوع هو المكان الذي حدث فيه الخطأ.
frames[] object (Frame)

اللقطات في تتبُّع تسلسل استدعاء الدوال البرمجية للعملية.
threadId string (int64 format)

معرّف سلسلة المحادثات، ولا يتوفّر إلا لسلاسل محادثات أخطاء ANR.
sysThreadId string (int64 format)

رقم تعريف نظام سلسلة التعليمات، وهو متاح فقط لسلاسل تعليمات ANR.
threadState enum (State)

النتائج فقط حالة سلسلة التعليمات في وقت حدوث خطأ ANR

State

حالة سلسلة التعليمات عند حدوث خطأ ANR

عمليات التعداد الوصف
STATE_UNSPECIFIED

لم يتم تحديد حالة سلسلة المحادثات.
THREAD_STATE_TERMINATED

تم إنهاء سلسلة المحادثات.
THREAD_STATE_RUNNABLE

كانت سلسلة المحادثات قابلة للتنفيذ.
THREAD_STATE_TIMED_WAITING

كانت سلسلة التعليمات تنتظر مع انتهاء المهلة.
THREAD_STATE_BLOCKED

تم حظر سلسلة المحادثات.
THREAD_STATE_WAITING

كانت سلسلة المحادثات في انتظار الرد.
THREAD_STATE_NEW

بدأت سلسلة المحادثات، ولكن لم يتم تشغيل أي شيء بعد.
THREAD_STATE_NATIVE_RUNNABLE

كانت السلسلة أصلية ولم نتمكّن من تحديد أنّها في حالة انتظار بشكل تجريبي، لذا نفترض أنّها قابلة للتنفيذ.
THREAD_STATE_NATIVE_WAITING

لقد حدّدنا بشكل تجريبي أنّ سلسلة المحادثات في حالة انتظار.


مخطط جلسات Firebase

FirebaseSessionEvent

الجلسات التي تسجّلها حزمة تطوير البرامج (SDK) الخاصة بميزة "جلسات جودة التطبيق" في Firebase

تمثيل JSON

{
  "sessionId": string,
  "eventType": enum (SessionEventType),
  "firstSessionId": string,
  "sessionIndex": integer,
  "firebaseInstallationId": string,
  "eventTime": string,
  "version": {
    object (Version)
  },
  "device": {
    object (Device)
  },
  "operatingSystem": {
    object (OperatingSystem)
  }
}
الحقول الوصف
sessionId string

المعرّف الفريد لجلسة Firebase.
eventType enum (SessionEventType)

نوع حدث الجلسة. لا تتوافق حزمة تطوير البرامج (SDK) حاليًا إلا مع أحداث SESSION_START.
firstSessionId string

معرّف الجلسة الأولى منذ آخر تشغيل على البارد سيكون هذا المعرّف ومعرّف الجلسة متطابقَين عند تشغيل التطبيق.
sessionIndex integer

تشير إلى عدد الجلسات منذ آخر عملية بدء تشغيل بارد.
firebaseInstallationId string

يحدّد جهازًا بشكلٍ فريد تم تثبيت تطبيقات Firebase عليه.
eventTime string (Timestamp format)

الطابع الزمني لبدء حدث الجلسة.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
version object (Version)

أرقام إصدارات تطبيقات الأجهزة الجوّالة
device object (Device)

البيانات الوصفية للأجهزة الجوّالة
operatingSystem object (OperatingSystem)

نظام التشغيل والإصدار.

SessionEventType

أنواع SessionEvent التي يتم تسجيلها.

عمليات التعداد الوصف
SESSION_EVENT_TYPE_UNKNOWN

غير معروف.
SESSION_START

بدأت جلسة التطبيق.


مخطط سجلّ الجهاز

DeviceLog

تمثّل بنية إدخالات deviceLog.

تمثيل JSON

{
  "eventId": string,
  "sessionId": string,

  // Union field payload can be only one of the following:
  "log": {
    object (Log)
  },
  "breadcrumb": {
    object (Breadcrumb)
  }
  // End of list of possible types for union field payload.
}
الحقول الوصف
eventId string

النتائج فقط غير قابل للتغيير: تمثّل هذه السمة معرّف الحدث المرتبط بهذا الخطأ.
sessionId string

المعرّف الفريد لجلسة Firebase.

حقل الدمج payload يمكن أن تكون الحمولة إما سجل Crashlytics أو Breadcrumb. يمكن أن تكون قيمة payload واحدة فقط مما يلي:
log object (Log)

سجلّ Crashlytics
breadcrumb object (Breadcrumb)

شريط التنقّل في Crashlytics

Log

أسطر السجلّ التي يقدّمها المطوّر والتي تم تسجيلها أثناء الجلسة

تمثيل JSON

{
  "logTime": string,
  "message": string
}
الحقول الوصف
logTime string (Timestamp format)

الطابع الزمني للجهاز عند تسجيل السطر

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
message string

رسالة السجلّ

Breadcrumb

أحداث "إحصاءات Google" التي تم تسجيلها خلال الجلسة

تمثيل JSON

{
  "eventTime": string,
  "title": string,
  "params": {
    string: string,
    ...
  }
}
الحقول الوصف
eventTime string (Timestamp format)

الطابع الزمني للحدث على الجهاز

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
title string

اسم حدث الإحصاءات
params map (key: string, value: string)

مَعلمات الأحداث

عنصر يحتوي على قائمة بأزواج "المفتاح": القيمة. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.