doctorgpt

دكتورGPT

يقوم DoctorGPT بإدخال GPT إلى الإنتاج لتشخيص الأخطاء! (ليست جاهزة للإنتاج بعد...)

يعد DoctorGPT برنامجًا ثنائيًا خفيف الوزن ومستقلًا يراقب سجلات التطبيق الخاصة بك بحثًا عن المشكلات ويشخصها.

الاستخدام

OPENAI_KEY=$YOUR_KEY doctorgpt --logfile="program.log" --configfile="config.yaml" --outdir="~/errors"

سيبدأ DoctorGPT في حذف program.log (بدون توقف). بالنسبة لكل سطر سجل، سيقوم المحللون المحددون من قبل المستخدم بتشغيل حدث تشخيص (استنادًا إلى تطابقات متغير regex) بإنشاء ملف تشخيص (انظر المثال أدناه) ضمن الدليل ~/errors باستخدام سطر السجل المُشغل وكل سياق السجل السابق باستخدام OpenAI API. يتم استخدام ملف config.yaml عند بدء التشغيل لتكوين البرنامج.

أعلام CLI

• --logfile (string) ملف السجل إلى الذيل والمراقبة
• --configfile (string) موقع ملف التكوين yaml
• --outdir (string) دليل ملفات التشخيص (يتم إنشاؤه إذا لم يكن موجودًا)
• --bundlingtimeoutseconds (int) انتظر بعض الوقت حتى تأتي السجلات بعد السطر الذي تم تشغيله (لعمليات تفريغ الأخطاء متعددة الأسطر) ( default: 5 )
• --debug (bool) تسجيل التصحيح ( default: true )
• --buffersize (int) الحد الأقصى لعدد إدخالات السجل لكل مخزن مؤقت ( default: 100 )
• --maxtokens (int) الحد الأقصى لعدد الرموز المميزة المسموح بها في واجهة برمجة التطبيقات ( default: 8000 )
• --gptmodel (string) نموذج GPT المطلوب استخدامه ( default: "gpt-4" ). للحصول على قائمة النماذج، راجع: نماذج OpenAI API

إعدادات

انظر مثال وثائق yaml:

 # Prompt to be sent alongside error context to the GPT API
prompt : " You are ErrorDebuggingGPT. Your sole purpose in this world is to help software engineers by diagnosing software system errors and bugs that can occur in any type of computer system. The message following the first line containing " ERROR: " up until the end of the prompt is a computer error no more and no less. It is your job to try to diagnose and fix what went wrong. Ready? n ERROR: n $ERROR "

parsers :

  # Matches line: [1217/201832.950515:ERROR:cache_util.cc(140)] Unable to move cache folder GPUCache to old_GPUCache_000
  - regex : ' ^[(d{4}/d{6}.d{6}):(?P<LEVEL>w+):([w._]+)(d+)]s+(?P<MESSAGE>.*)$ '

    # Conditions in which the parsed log will trigger a diagnosis
    triggers :
      - variable : " LEVEL "
        regex :    " ERROR "

    # Conditions in which the parsed log will be ignored for triggers
    # To create exceptions which won't trigger the GPT API
    filters :
      - variable : " MESSAGE "
        regex :    " HTTP 401 "

    # Conditions in which the parsed log will be ignored and excluded from the API context
    # For sensitive or spammy log entries. These will never be sent to the GPT API
    excludes :
      - variable : " LEVEL "
        regex :    " DEBUG "

  # Matches line:  2022-01-27 21:37:36.776 0x2eb3     Default       511 photolibraryd: PLModelMigration.m:314   Creating sqlite error indicator file
  - regex : ' ^(?P<DATE>[^ ]+)s+(?P<TIME>[^ ]+)s+[^ ]+(?P<LEVEL>[^ ]+)s+(?P<MESSAGE>.*)$ '

  # When more than one trigger is present, just one trigger is sufficient to trigger a diagnosis
    triggers :
      - variable : " LEVEL "
        regex :    " Default "
      - variable : " MESSAGE "
        regex :    " (?i)ERROR: "
    # Filters and excludes were not specified

  # Last parser must always be a generic one that matches any line
  - regex : ' ^(?P<MESSAGE>.*)$ '
    # All filters, triggers and excludes were not specified 

مثال

هذه هي الطريقة التي يبدو بها الملف ::Users::yamilmolinar::error.log:18.diagnosed :

 LOG LINE:
/Users/yamilmolinar/error.log:18

BASE PROMPT:
 You are ErrorDebuggingGPT. Your sole purpose in this world is to help software engineers by diagnosing software system errors and bugs that can occur in any type of computer system. The message following the first line containing "ERROR:" up until the end of the prompt is a computer error no more and no less. It is your job to try to diagnose and fix what went wrong. Ready?nERROR:n$ERROR

CONTEXT:
yarn run v1.22.19
$ tsnd --respawn --transpile-only --no-notify --ignore-watch node_modules src/index.ts
[INFO] 15:20:25 ts-node-dev ver. 2.0.0 (using ts-node ver. 10.8.0, typescript ver. 4.8.4)
[INFO]  DB ready
[INFO]  Auth ready
[INFO]  Apollo setup
[INFO]  Server started at http://localhost:5555/graphql 

Query: Me
POST /graphql 200 241.389 ms - 21

prisma:query SELECT 1
prisma:query SELECT "public"."User"."id", "public"."User"."email", "public"."User"."password", "public"."User"."firstName", "public"."User"."lastName", "public"."User"."avatar", "public"."User"."role", "public"."User"."bio", "public"."User"."createdAt", "public"."User"."updatedAt" FROM "public"."User" WHERE "public"."User"."email" = $2 LIMIT $2 OFFSET $3
[ERROR]  PrismaClientKnownRequestError:
Invalid `prisma.user.findFirst()` invocation in
/Users/yamilmolinar/Repos/boilerplate/packages/api/src/modules/user/user.service.ts:32:36

  29 }
  30
  31 async checkUserExists(where: UserWhereInput) {
→ 32   const user = await prisma.user.findFirst(
The table `public.User` does not exist in the current database.
    at RequestHandler.handleRequestError (/Users/yamilmolinar/Repos/boilerplate/node_modules/@prisma/client/runtime/index.js:30851:13)
    at RequestHandler.request (/Users/yamilmolinar/Repos/boilerplate/node_modules/@prisma/client/runtime/index.js:30834:12)
    at PrismaClient._request (/Users/yamilmolinar/Repos/boilerplate/node_modules/@prisma/client/runtime/index.js:31812:16)
    at UserService.checkUserExists (/Users/yamilmolinar/Repos/boilerplate/packages/api/src/modules/user/user.service.ts:32:18)
    at UserService.register (/Users/yamilmolinar/Repos/boilerplate/packages/api/src/modules/user/user.service.ts:26:5)
    at UserResolver.register (/Users/yamilmolinar/Repos/boilerplate/packages/api/src/modules/user/user.resolver.ts:93:18)
    at dispatchHandler (/Users/yamilmolinar/Repos/boilerplate/node_modules/type-graphql/dist/resolvers/helpers.js:82:24)
    at /Users/yamilmolinar/Repos/boilerplate/node_modules/type-graphql/dist/resolvers/helpers.js:83:26
    at ErrorInterceptor (/Users/yamilmolinar/Repos/boilerplate/packages/api/src/lib/globalMiddleware.ts:29:12)
    at dispatchHandler (/Users/yamilmolinar/Repos/boilerplate/node_modules/type-graphql/dist/resolvers/helpers.js:82:24) {
  code: 'P2021',
  clientVersion: '4.4.0',
  meta: { table: 'public.User' }
}

Mutation: Register
POST /graphql 200 365.616 ms - 2139

DIAGNOSIS:
It seems the error is caused by a missing table in the database. The table `public.User` does not exist in the current database, and this is causing the `PrismaClientKnownRequestError` to be thrown when trying to execute `prisma.user.findFirst()` in the `UserService.checkUserExists()` function.

To resolve this issue, follow these steps:

1. Ensure that you have properly set up your database schema and that the `public.User` table is defined. If it's not, add the necessary schema definition for the User table.

2. Ensure that Prisma is properly configured to connect to your database. Double-check the configuration in your `prisma/schema.prisma` file, and make sure the database URL and other settings are correct.

3. Run a migration to update your actual database's schema. You can do this by running the following command:

npx prisma migrate dev --name init --preview-feature

This command will create the necessary tables in your database based on your Prisma schema file, apply the migration, and generate the Prisma Client.

4. After running the migration, restart your server and test your application again to ensure that the error is resolved.

If you still encounter issues, double-check your Prisma configuration, as well as your database connection settings, and ensure your code logic is correct.

مكتبة المحلل اللغوي (سيتم تحسينها)

توجد مكتبة لموزعي السجلات الشائعة في config.yaml . تم اختبار هؤلاء المحللين مقابل السجلات الحقيقية في testlogs/*_2k.log .

1. أندرويد
2. أباتشي
3. HDFS
4. هادوب
5. لينكس
6. ماك
7. شرارة
8. ويندوز

راجع parsers_test.go للاختبارات وloghub لمزيد من عينات السجل.

تثبيت

باستخدام go install :

• GOBIN=/usr/local/bin go install "github.com/ingyamilmolinar/doctorgpt/agent"

التبعيات

1. مترجم Go (لإنشاء الاختبارات وتشغيلها فقط)
2. docker (للتطوير)
3. k3d (للتطوير)
4. kubectl (للتنمية)
5. make (للتنمية)

الميزات (للتعزيز)

1. بيئة ثنائية مستقلة مكتفية ذاتيًا وخفيفة الوزن (8.3 ميجابايت). (دعم Windows مفقود ولكن يمكن إضافته بسهولة)
2. صورة ألباين لينكس دوكر
3. موجه chatGPT قابل للتكوين
4. يدعم كل إصدار من طراز GPT
5. مطابقة تنسيقات سجل متعددة داخل نفس الملف
6. قم بمطابقة موزعين متعددين لإدخال السجل نفسه
7. قم بمطابقة مرشحات متعددة لنفس إدخال السجل
8. تجاهل السجلات حتى لا تكون جزءًا من السياق (للمعلومات الحساسة أو غير المرغوب فيها)
9. دعم أسماء المتغيرات المخصصة
10. تنسيق regex قوي (نكهة Perl/Go)
11. تعظيم مقدار سياق السجل في التشخيص

العمل قيد التقدم

1. تقسيم سياقات السجل لكل مطابقة regex مخصصة في قيم متغيرة
2. تعزيز مكتبة موزعي السجل المشترك

العمل المستقبلي

1. تحليل التسجيل المنظم
2. قم بإنشاء config.yaml استنادًا إلى أمثلة سجل الحياة الواقعية (تهيئة التمهيد باستخدام GPT)
3. صورة عامل إرساء خفيفة الوزن "من الصفر".
4. استراتيجية الإصدار وCI
5. دعم ويندوز / ماك
6. دعم الأنواع المخصصة (لمقارنات الطوابع الزمنية، وما إلى ذلك)
7. جاهزية الإنتاج (الأمان، المصادقة، المراقبة، التحسين، المزيد من الاختبارات...)
8. تكامل Sentry SDK
9. مخطط الخوذة

تطوير

• export OPENAI_API=<your-api-key>
• make k4d-create (لإنشاء مجموعة k3d)
• make k3d-delete (لحذف مجموعة k3d) ملاحظة: راجع Makefile لمزيد من الأوامر

الاختبار (الاختبارات لا تستخدم OpenAI API)

• cd agent; go test ./...; cd -
• cd agent; go test -v ./...; cd - (الوضع المطول)

المساهمة

لا تتردد في فتح مشكلة باقتراحك حول كيفية جعل هذا البرنامج أكثر فائدة ومحمولًا وفعالًا وجاهزًا للإنتاج (وبالطبع الأخطاء!).

لا تتردد في فتح MRs. سأقوم بمراجعتهم إذا رأيت أنهم يتبعون فلسفة هذا المشروع. بالنسبة لأجزاء أكبر من العمل أو تغييرات التصميم، يرجى فتح مشكلة أولاً حتى يمكن مناقشة الإستراتيجية.