logologo
البدء
الدليل
التطوير
الإضافات
API
English
简体中文
日本語
한국어
Deutsch
Français
Español
Português
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
البدء
الدليل
التطوير
الإضافات
API
logologo

بدء سريع

نظرة عامة على تطوير الإضافات
كتابة الإضافة الأولى
هيكل دليل المشروع

تطوير الواجهة الخلفية

نظرة عامة
Plugin
جداول بيانات Collections
عمليات Database
إدارة مصادر بيانات DataSourceManager
إدارة موارد ResourceManager
التحكم في أذونات ACL
Middleware
Cache
Event
سياق طلب Context
نص ترقية Migration
Logger
Telemetry
I18n (تدويل)
Command (سطر الأوامر)
إدارة المهام المجدولة CronJobManager
Test

تطوير الواجهة الأمامية

نظرة عامة
Plugin
Context (السياق)
Router
التحكم في أذونات ACL
إدارة مصادر بيانات DataSourceManager
Resource
Request
Styles & Themes (الأنماط والمظاهر)
Logger
I18n (تدويل)
Test

أخرى

دليل ترقية الإضافات
قائمة اللغات
إدارة التبعيات
البناء
Previous PageLogger
Next PageI18n (تدويل)
إشعار الترجمة بالذكاء الاصطناعي

تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.

#القياس عن بعد

تجريبي

وحدة القياس عن بعد (Telemetry) في NocoBase مبنية على OpenTelemetry. توضح هذه المقالة كيفية استخدام وحدة القياس عن بعد لجمع بيانات التتبع (Trace) والمقاييس (Metric) لتعزيز قابلية المراقبة (Observability) لنظام NocoBase.

#التزويد بالأدوات

#المقاييس

const meter = app.telemetry.metric.getMeter();
const counter = meter.createCounter('event_counter', {});
counter.add(1);

المراجع:

  • https://opentelemetry.io/docs/instrumentation/js/manual/#acquiring-a-meter

#التتبع

const tracer = app.telemetry.trace.getTracer();
tracer.startActiveSpan();
tracer.startSpan();

المراجع:

  • https://opentelemetry.io/docs/instrumentation/js/manual/#acquiring-a-tracer

#المكتبات

import { Plugin } from '@nocobase/server';
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';

class InstrumentationPlugin extends Plugin {
  afterAdd() {
    this.app.on('beforeLoad', (app) => {
      app.telemetry.addInstrumentation(getNodeAutoInstrumentations());
    });
  }
}
ملاحظة

موقع تهيئة وحدة القياس عن بعد في NocoBase هو app.beforeLoad. لذلك، ليست كل مكتبات التزويد بالأدوات مناسبة لـ NocoBase.
على سبيل المثال: يجب تضمين instrumentation-koa قبل تهيئة Koa، ولكن على الرغم من أن Application في NocoBase مبنية على Koa، فإن وحدة القياس عن بعد تتم تهيئتها بعد تهيئة Application، مما يجعلها غير قابلة للتطبيق في هذه الحالة.

المراجع:

  • https://opentelemetry.io/docs/instrumentation/js/libraries/

#التجميع

#المقاييس

import { Plugin } from '@nocobase/server';
import {
  PeriodicExportingMetricReader,
  ConsoleMetricExporter,
} from '@opentelemetry/sdk-metrics';

class MetricReaderPlugin extends Plugin {
  afterAdd() {
    this.app.on('beforeLoad', (app) => {
      app.telemetry.metric.registerReader(
        'console',
        () =>
          new PeriodicExportingMetricReader({
            exporter: new ConsoleMetricExporter(),
          }),
      );
    });
  }
}

#التتبع

import { Plugin } from '@nocobase/server';
import {
  BatchSpanProcessor,
  ConsoleSpanExporter,
} from '@opentelemetry/sdk-trace-base';

class TraceSpanProcessorPlugin extends Plugin {
  afterAdd() {
    this.app.on('beforeLoad', (app) => {
      app.telemetry.trace.registerProcessor(
        'console',
        () => new BatchSpanProcessor(new ConsoleSpanExporter()),
      );
    });
  }
}

المراجع:

  • https://opentelemetry.io/docs/instrumentation/js/exporters