القياس عن بُعد
يمكنك استيعاب المقاييس التي يجمعها خادم تويست باستخدام [Prometheus] (https://prometheus.io/) وأداة تصور مثل [Grafana] (https://grafana.com/) لإنشاء لوحة معلومات مخصصة مصممة خصيصًا لتلبية احتياجاتك. يتم تقديم مقاييس بروميثيوس عبر نقطة النهاية /metrics على المنفذ 9091. يجب تعيين [scrape_interval] (https://prometheus.io/docs/introduction/first_steps/#configuring-prometheus) في بروميثيوس على أقل من 10_000 ثانية (نوصي بالحفاظ على الإعداد الافتراضي 15 ثانية).
تحليلات بوست هوغ
يتكامل تويست مع [PostHog] (https://posthog.com/) لتحليل سلوك المستخدم وتتبع الأحداث. يتيح لك ذلك فهم كيفية تفاعل المستخدمين مع خادم تويست الخاص بك، وتتبع استخدام الميزات، واكتساب رؤى حول سلوك المستخدم عبر موقع التسويق ولوحة المعلومات ووثائق واجهة برمجة التطبيقات.
تهيئة
يعد تكامل PostHog اختياريًا ويمكن تمكينه عن طريق تعيين متغيرات البيئة المناسبة. عند تهيئته، سيقوم تويست تلقائيًا بتتبع أحداث المستخدم، ومشاهدات الصفحة، ورحلات المستخدم.
| متغير البيئة | الوصف | مطلوب | افتراضي | مثال على ذلك |
|---|---|---|---|---|
tuist_posthog_api_key_API_key | مفتاح واجهة برمجة التطبيقات لمشروع PostHog الخاص بك | لا يوجد | phc_fpR9c0Hs5Hs5H5H5VXXUsupUsupU1I0WLWLEq366FaZH6H6HJR3lRIWVR | |
tuist_posthog_url | عنوان URL نقطة نهاية واجهة برمجة تطبيقات PostHog | لا يوجد | https://eu.i.posthog.com |
عن تمكين التحليلات
يتم تمكين التحليلات فقط عندما يتم تكوين كل من TUIST_POSTHOG_API_KEY و TUIST_POSTHOG_URL. إذا كان أي من المتغيرين مفقودًا، فلن يتم إرسال أي أحداث تحليلية.
الميزات
عند تمكين PostHog، يتتبع تويست تلقائيًا:
- تعريف المستخدم: يتم التعرف على المستخدمين من خلال معرفهم الفريد وعنوان بريدهم الإلكتروني
- تسمية المستخدم المستعار: يتم تسمية المستخدمين بأسماء مستعارة بأسماء حساباتهم لتسهيل التعرف عليهم
- تحليلات المجموعة: يتم تجميع المستخدمين حسب المشروع والمؤسسة التي اختاروها لإجراء تحليلات مجزأة
- أقسام الصفحة: تتضمن الأحداث خصائص فائقة تشير إلى قسم التطبيق الذي أنشأها:
تسويق- أحداث من صفحات التسويق والمحتوى العاملوحة التحكم- الأحداث من لوحة تحكم التطبيق الرئيسية والمناطق المصادق عليهاapi-docs- أحداث من صفحات وثائق API
- مشاهدات الصفحة: التتبع التلقائي لتصفح الصفحات باستخدام فينيكس لايف فيو
- أحداث مخصصة: أحداث خاصة بالتطبيق لاستخدام الميزة وتفاعلات المستخدم
اعتبارات الخصوصية
- بالنسبة للمستخدمين الذين تمت مصادقتهم، يستخدم PostHog المعرف الفريد للمستخدم كمعرف مميز ويتضمن عنوان بريده الإلكتروني
- بالنسبة للمستخدمين مجهولي الهوية، يستخدم PostHog الثبات في الذاكرة فقط لتجنب تخزين البيانات محليًا
- تحترم جميع التحليلات خصوصية المستخدم وتتبع أفضل ممارسات حماية البيانات
- تتم معالجة بيانات PostHog وفقًا لسياسة خصوصية PostHog وتكوينك
مقاييس إليكسير
بشكل افتراضي، نقوم بتضمين مقاييس وقت تشغيل إليكسير و BEAM وإليكسير وبعض المكتبات التي نستخدمها. فيما يلي بعض المقاييس التي يمكنك توقع رؤيتها:
- [التطبيق] (https://hexdocs.pm/prom_ex/PromEx.Plugins.Application.html)
- [بيم] (https://hexdocs.pm/prom_ex/PromEx.Plugins.Beam.html)
- [فينيكس] (https://hexdocs.pm/prom_ex/PromEx.Plugins.Phoenix.html)
- [فينيكس لايف فيو] (https://hexdocs.pm/prom_ex/PromEx.Plugins.PhoenixLiveView.html)
- [إكتو] (https://hexdocs.pm/prom_ex/PromEx.Plugins.Ecto.html)
- [أوبان] (https://hexdocs.pm/prom_ex/PromEx.Plugins.Oban.html)
نوصي بمراجعة تلك الصفحات لمعرفة المقاييس المتاحة وكيفية استخدامها.
تشغيل المقاييس
مجموعة من المقاييس المتعلقة بتشغيلات تويست.
tuist_runs_total (عداد)
إجمالي عدد مرات تشغيل تويست.
الوسوم
| الوسم | الوصف |
|---|---|
الاسم | اسم الأمر tuist الذي تم تشغيله، مثل بناء ، اختبار ، إلخ. |
is_ci | قيمة منطقية تشير إلى ما إذا كان المنفِّذ مخبر سري أو جهاز مطور. |
الحالة | 0 في حالة النجاح ، ، 1 في حالة الفشل. |
tuist_runs_duration_duration_milliseconds (رسم بياني)
المدة الإجمالية لكل تشغيل تويست بالمللي ثانية.
العلامات
| الوسم | الوصف |
|---|---|
الاسم | اسم الأمر tuist الذي تم تشغيله، مثل بناء ، اختبار ، إلخ. |
is_ci | قيمة منطقية تشير إلى ما إذا كان المنفِّذ مخبر سري أو جهاز مطور. |
الحالة | 0 في حالة النجاح ، ، 1 في حالة الفشل. |
مقاييس ذاكرة التخزين المؤقت
مجموعة من المقاييس المتعلقة بذاكرة التخزين المؤقت لتويست.
tuist_cache_cache_events_total (عداد)
إجمالي عدد أحداث ذاكرة التخزين المؤقت الثنائية.
الوسوم
| الوسم | الوصف |
|---|---|
نوع_الحدث | يمكن أن يكون إما من إصابة محلية أو إصابة عن بُعد أو تفويت. |
tuist_cache_cuploads_uploads_total (عداد)
عدد عمليات التحميل إلى ذاكرة التخزين المؤقت الثنائية.
tuist_cache_cache_uploaded_bytes (المجموع)
عدد وحدات البايت التي تم تحميلها إلى ذاكرة التخزين المؤقت الثنائية.
tuist_cache_cdownloads_downloads_total (عداد)
عدد التنزيلات إلى ذاكرة التخزين المؤقت الثنائية.
tuist_cache_cache_downloaded_bytes (المجموع)
عدد وحدات البايت التي تم تنزيلها من ذاكرة التخزين المؤقت الثنائية.
مقاييس المعاينة
مجموعة من المقاييس المتعلقة بميزة المعاينات.
tuist_previews_previews_uploads_total (المجموع)
إجمالي عدد المعاينات التي تم تحميلها.
tuist_previews_previews_downloads_total (المجموع)
إجمالي عدد المعاينات التي تم تنزيلها.
مقاييس التخزين
مجموعة من المقاييس المتعلقة بتخزين القطع الأثرية في مخزن بعيد (مثل s3).
TIP
هذه المقاييس مفيدة لفهم أداء عمليات التخزين وتحديد الاختناقات المحتملة.
tuist_storage_get_get_object_size_size_size_size_bytes (رسم بياني)
حجم (بالبايت) الكائن الذي تم جلبه من وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_get_get_object_size_size_duration_miliseconds (رسم بياني)
المدة (بالمللي ثانية) لجلب حجم كائن من وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_get_get_obget_size_size_count (عداد)
عدد المرات التي تم فيها جلب حجم الكائن من وحدة التخزين عن بُعد.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_delete_all_dall_objects_duration_milliseconds_milliseconds (رسم بياني)
المدة (بالمللي ثانية) لحذف جميع الكائنات من وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
سبيكة_المشروع | سبيكة المشروع للمشروع الذي يتم حذف كائناته. |
tuist_storage_delete_all_storage_delete_all_objects_counts_count (عداد)
عدد المرات التي تم فيها حذف جميع كائنات المشروع من وحدة التخزين عن بُعد.
العلامات
| الوسم | الوصف |
|---|---|
سبيكة_المشروع | سبيكة المشروع للمشروع الذي يتم حذف كائناته. |
tuist_storage_multipart_start_start_upart_upart_upart_upload_duration_milliseconds (رسم بياني)
المدة (بالمللي ثانية) لبدء التحميل إلى وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_multipart_start_start_upart_upload_dupuration_duration_count (عداد)
عدد مرات بدء التحميل إلى وحدة التخزين عن بُعد.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_get_get_object_as_string_duration_milliseconds (رسم بياني)
المدة (بالمللي ثانية) لجلب كائن كسلسلة من وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_get_get_object_as_string_count (العد)
عدد المرات التي تم فيها جلب كائن كسلسلة من وحدة التخزين البعيدة.
الوسوم
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_stcheck_object_existence_dexence_duration_milliseconds (رسم بياني)
المدة (بالمللي ثانية) للتحقق من وجود كائن في وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_stecheck_object_exist_existence_count (العد)
عدد المرات التي تم فيها التحقق من وجود كائن في المخزن البعيد.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_generate_download_download_presigned_url_url_durl_duration_milliseconds (رسم بياني)
المدة (بالمللي ثانية) لإنشاء عنوان URL محدد مسبقاً للتنزيل لكائن في وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_generate_downloadate_download_presigned_url_url_count (العد)
عدد المرات التي تم فيها إنشاء عنوان URL محدد مسبقاً للتنزيل لكائن في وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
tuist_storage_multipart_generate_upload_upload_part_presigned_purl_purl_purl_milliseconds_milliseconds (رسم بياني)
المدة (بالمللي ثانية) لإنشاء عنوان URL محدد مسبقاً لتحميل جزء من التحميل لكائن في وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
رقم_الجزء | رقم الجزء الخاص بالكائن الذي يتم تحميله. |
تحميل_معرف | معرف التحميل الخاص بالتحميل متعدد الأجزاء. |
tuist_storage_multipart_generate_upload_upload_part_presigned_purl_count (العد)
عدد المرات التي تم فيها إنشاء عنوان URL محدد مسبقاً لتحميل جزء لكائن في وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
رقم_الجزء | رقم الجزء الخاص بالكائن الذي يتم تحميله. |
تحميل_معرف | معرف التحميل الخاص بالتحميل متعدد الأجزاء. |
tuist_storage_multipart_complete_compload_uplete_upload_duration_milliseconds (رسم بياني)
المدة (بالمللي ثانية) لإكمال التحميل إلى وحدة التخزين البعيدة.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
تحميل_معرف | معرف التحميل الخاص بالتحميل متعدد الأجزاء. |
tuist_storage_storage_multipart_complete_complete_upload_count (العد)
العدد الإجمالي لمرات اكتمال التحميل إلى وحدة التخزين عن بُعد.
العلامات
| الوسم | الوصف |
|---|---|
مفتاح_الكائن | مفتاح البحث عن الكائن في وحدة التخزين البعيدة. |
تحميل_معرف | معرف التحميل الخاص بالتحميل متعدد الأجزاء. |
مقاييس المصادقة
مجموعة من المقاييس المتعلقة بالمصادقة.
tuist_authentication_authentication_token_refresh_refresh_error_total (عداد)
العدد الإجمالي لأخطاء تحديث الرمز المميز.
العلامات
| الوسم | الوصف |
|---|---|
cli_إصدار | إصدار Twist CLI الذي واجه الخطأ. |
السبب | سبب خطأ تحديث الرمز المميز، مثل غير صالح_رمز_مُرمز_نوع أو غير صالح_رمز مميز. |
مقاييس المشاريع
مجموعة من المقاييس المتعلقة بالمشاريع.
tuist_projects_projects_total (آخر_قيمة)
العدد الإجمالي للمشاريع.
مقاييس الحسابات
مجموعة من المقاييس المتعلقة بالحسابات (المستخدمين ومنتديات المجموعة).
tuist_accounts_accounts_organizations_total (آخر_قيمة)
إجمالي عدد المنظمات.
tuist_accounts_accounts_accounts_users_total (آخر_قيمة)
إجمالي عدد المستخدمين.
مقاييس قاعدة البيانات
مجموعة من المقاييس المتعلقة باتصال قاعدة البيانات.
tuist_repo_repo_pool_checkout_queout_queue_length (آخر_قيمة)
عدد استعلامات قاعدة البيانات الموجودة في قائمة الانتظار في انتظار تعيينها لاتصال قاعدة البيانات.
tuist_repo_repo_repo_pool_ready_conn_count (آخر_قيمة)
عدد اتصالات قاعدة البيانات الجاهزة للتعيين لاستعلام قاعدة البيانات.
tuist_repo_repo_dpool_dpool_db_db_connection_connconnected (عداد)
عدد الاتصالات التي تم إنشاؤها بقاعدة البيانات.
tuist_repo_repo_pool_db_db_db_dconnection_disconnected (عداد)
عدد الاتصالات التي تم قطع اتصالها بقاعدة البيانات.
مقاييس HTTP
مجموعة من المقاييس المتعلقة بتفاعلات تويست مع الخدمات الأخرى عبر HTTP.
tuist_http_http_request_count (عداد)
عدد طلبات HTTP الصادرة.
tuist_http_http_request_request_duration_nanosecond_nanosecond_sum (المجموع)
مجموع مدة الطلبات الصادرة (بما في ذلك الوقت الذي استغرقته في انتظار تعيين اتصال).
tuist_http_http_request_request_duration_nanosecond_nanosecond_bucket (التوزيع)
توزيع مدة الطلبات الصادرة (بما في ذلك الوقت الذي استغرقته في انتظار تعيين اتصال).
tuist_http_http_queue_count (عداد)
عدد الطلبات التي تم استردادها من المجمع.
tuist_http_http_queue_due_due_duration_nanoseconds_nanoseconds_sum (المجموع)
الوقت الذي يستغرقه استرداد اتصال من المجمع.
tuist_http_http_quettp_queue_queue_idue_time_nanoseconds_nanoseconds_nanoseconds_sum (المجموع)
الوقت الذي ظل فيه الاتصال خاملاً في انتظار الاسترداد.
tuist_http_http_queue_due_due_duration_nanoseconds_nanoseconds_bucket (التوزيع)
الوقت الذي يستغرقه استرداد اتصال من المجمع.
tuist_http_http_quettp_queue_queue_idue_idue_time_nanoseconds_nanoseconds_nanoseconds_bucket (التوزيع)
الوقت الذي ظل فيه الاتصال خاملاً في انتظار الاسترداد.
tuist_http_http_connection_count (عداد)
عدد الاتصالات التي تم إنشاؤها.
tuist_http_http_donnection_donnection_duration_nanoseconds_nanoseconds_sum (المجموع)
الوقت الذي يستغرقه إنشاء اتصال مقابل مضيف.
tuist_http_http_donnection_dconnection_duration_nanoseconds_nanoseconds_nanoseconds_bucket (التوزيع)
توزيع الوقت الذي يستغرقه إنشاء اتصال مقابل مضيف.
tuist_http_http_send_count (عداد)
عدد الطلبات التي تم إرسالها بمجرد تعيينها إلى اتصال من مجموعة الاتصالات.
tuist_http_http_send_send_duration_nanoseconds_nanoseconds_nanoseconds_sum (المجموع)
الوقت الذي تستغرقه الطلبات لإكمالها بمجرد تعيينها إلى اتصال من مجموعة الاتصالات.
tuist_http_http_send_send_duration_nanoseconds_nanoseconds_nanoseconds_bucket (التوزيع)
توزيع الوقت الذي تستغرقه الطلبات لإكمالها بمجرد تعيينها إلى اتصال من مجموعة الاتصالات.
tuist_http_http_receive_count (عداد)
عدد الردود التي تم استلامها من الطلبات المرسلة.
tuist_http_http_receive_dreceive_duration_nanoseconds_nanoseconds_sum (المجموع)
الوقت المستغرق في تلقي الردود.
tuist_http_http_receive_dreceive_duration_nanoseconds_nanoseconds_nanoseconds_bucket (التوزيع)
توزيع الوقت المستغرق في تلقي الردود.
tuist_http_http_queue_available_avconnections (آخر_قيمة)
عدد الاتصالات المتوفرة في قائمة الانتظار.
tuist_http_http_queue_in_in_use_connections (آخر_قيمة)
عدد اتصالات قائمة الانتظار قيد الاستخدام.