grafana wtf

grafana-wtf

عن

grafana-wtf - grep عبر جميع كيانات Grafana بروح git-wtf.

انتباه!

يمكن لهذا البرنامج أن يضع حملاً كبيرًا على مثيل Grafana الخاص بك وآلية قاعدة البيانات الأساسية. تعامل بعناية!

ملخص

ابحث في Grafana (لوحات المعلومات ومصادر البيانات) عن السلسلة "weatherbase".

 grafana-wtf ابحث عن قاعدة الطقس

عرض أحدث 50 تغييرًا عبر جميع لوحات المعلومات.

 سجل grafana-wtf --الرقم=50

استكشف لوحات المعلومات ومصادر البيانات بمزيد من التفاصيل.

 grafana-wtf استكشاف لوحات المعلومات
grafana-wtf استكشاف مصادر البيانات

استكشاف المكونات الإضافية.

 قائمة الإضافات grafana-wtf
حالة المكونات الإضافية grafana-wtf

التشغيل باستخدام Docker:

 # الوصول إلى مثيل Grafana على المضيف المحلي، دون مصادقة.
تشغيل عامل الإرساء --rm -it 
    --env GRAFANA_URL="http://host.docker.internal:3000" 
    ghcr.io/grafana-toolbox/grafana-wtf معلومات grafana-wtf

# الوصول إلى مثيل Grafana بالمصادقة.
تشغيل عامل الإرساء --rm -it 
    --env GRAFANA_URL="https://grafana.example.org/grafana" 
    --env GRAFANA_TOKEN="eyJrIjoiWHg...dGJpZCI6MX0=" 
    ghcr.io/grafana-toolbox/grafana-wtf معلومات grafana-wtf

لقطات الشاشة

grafana-wtf find

grafana-wtf log

يثبت

قم بتثبيت grafana-wtf

 تثبيت النقطة grafana-wtf

تكوين جرافانا

يرجى اتخاذ هذه الخطوات لإنشاء مفتاح API مع مثيل Grafana الخاص بك:

• انتقل إلى https://daq.example.org/grafana/org/apikeys .
• اختر "مفتاح واجهة برمجة التطبيقات الجديد".
  • الاسم الرئيسي: جرافانا وتف
  • الدور: المشرف
• من curl -H "Authorization: Bearer eyJrIjoiWHg...dGJpZCI6MX0=" ... ، يرجى ملاحظة رمز Bearer المميز. هذا هو مفتاح Grafana API الخاص بك.

إعدادات

اتصال جرافانا

لتكوين مثيل Grafana الذي سيتم الاتصال به وكيفية المصادقة، استخدم خيارات سطر الأوامر --grafana-url و --grafana-token .

بدلاً من ذلك، قبل تشغيل grafana-wtf ، يمكنك تحديد عنوان URL ورمز الوصول لمثيل Grafana الخاص بك باستخدام متغيرات البيئة:

 تصدير GRAFANA_URL=https://daq.example.org/grafana/
تصدير GRAFANA_TOKEN=eyJrIjoiWHg...dGJpZCI6MX0=

من أجل قبول شهادات SSL غير الموثوق بها، قم بإلحاق سلسلة الاستعلام ?verify=no إلى GRAFANA_URL :

 تصدير GRAFANA_URL=https://daq.example.org/grafana/?verify=no

التخزين المؤقت

سيقوم grafana-wtf بالتخزين المؤقت لاستجابات HTTP لمدة 60 دقيقة بشكل افتراضي، من أجل توفير الموارد، من خلال عدم ضرب الخادم لكل خادم. يمكنك تكوين هذا الإعداد باستخدام خيار --cache-ttl ، أو متغير البيئة CACHE_TTL .

عند استدعاء البرنامج باستخدام خيار --drop-cache ، فإنه سيسقط ذاكرة التخزين المؤقت الخاصة به مقدمًا.

الاستخدام

معلومات عامة

 # عرض مجموعة من المعلومات والإحصائيات التعريفية.
معلومات grafana-wtf --format=yaml

# عرض نسخة جرافانا.
معلومات grafana-wtf --format=json | jq -r '.grafana.version'

استكشاف مصادر البيانات

كيف تجد مصادر البيانات غير المستخدمة؟

 # عرض جميع مصادر البيانات ولوحات المعلومات المستخدمة لها وكذلك مصادر البيانات غير المستخدمة.
grafana-wtf استكشاف مصادر البيانات --format=yaml

# عرض أسماء مصادر البيانات غير المستخدمة كقائمة مسطحة.
grafana-wtf استكشاف مصادر البيانات --format=json | jq -r ".unused[].datasource.name"

استكشف لوحات المعلومات

كيف يمكنك العثور على لوحات المعلومات التي تستخدم مصادر بيانات غير موجودة؟

 # عرض بعض التفاصيل لجميع لوحات المعلومات، بما في ذلك أسماء مصادر البيانات المفقودة.
grafana-wtf استكشاف لوحات المعلومات --format=yaml

# عرض فقط لوحات المعلومات التي تحتوي على مصادر بيانات مفقودة، بالإضافة إلى أسمائها.
grafana-wtf استكشاف لوحات المعلومات --format=json | 
    جي كيو '.[] | حدد(.datasources_missing) | .dashboard + {ds_missing: .datasources_missing[] | [.اسم]}'

كيف يمكن العثور على لوحات المعلومات باستخدام مصادر بيانات محددة؟

 # عرض جميع لوحات المعلومات التي تستخدم مصدر بيانات محدد، مع تصفيتها حسب اسم مصدر البيانات.
grafana-wtf استكشاف لوحات المعلومات --format=json | جي كيو '.[] | حدد(.datasources | .[].type=="<datasource_name>")'

# عرض جميع لوحات المعلومات باستخدام مصادر البيانات بنوع معين. هنا: InfluxDB.
grafana-wtf استكشاف لوحات المعلومات --format=json | جي كيو '.[] | حدد(.datasources | .[].type=="influxdb")'

كيفية سرد جميع الاستعلامات المستخدمة في جميع لوحات المعلومات؟

 grafana-wtf استكشاف لوحات المعلومات --تفاصيل البيانات --الاستعلامات فقط --format=json | 
    جي كيو '.[].تفاصيل | القيم[] | .[] | .expr،.jql،.query،.rawSql | حدد( . != فارغ و . != "" )"

البحث عن سلاسل

ابحث عن weatherbase للسلسلة في جميع لوحات المعلومات ومصادر البيانات:

 grafana-wtf ابحث عن قاعدة الطقس

استبدال السلاسل

استبدل كل تكرارات ldi_v2 بـ ldi_v3 داخل لوحة المعلومات بـ UID _JJ22OZZk :

 grafana-wtf --select-dashboard=_JJ22OZZk استبدل ldi_v2 ldi_v3

لمعاينة التغييرات، يجب عليك استخدام خيار --dry-run مسبقًا:

 grafana-wtf --select-dashboard=_JJ22OZZk استبدل ldi_v2 ldi_v3 --dry-run

عرض تاريخ التحرير

هل تراقب نشاط التحرير الأخير على أي لوحات معلومات؟

 # عرض أحدث 50 تغييرًا في جميع لوحات المعلومات.
سجل grafana-wtf --الرقم=50

أمثلة

لاكتشاف المزيد من معلمات سطر الأوامر ووسائطها، يرجى استدعاء grafana-wtf --help وإلقاء نظرة على أمثلة grafana-wtf.

تطوير

 استنساخ بوابة https://github.com/grafana-toolbox/grafana-wtf
قرص مضغوط جرافانا وتف

# تشغيل كافة الاختبارات.
إجراء اختبار

# تشغيل الاختبارات المحددة.
pytest --keepalive -vvv -k test_find_textual