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
כתיבת Plugin ראשון
מבנה תיקיות הפרויקט

פיתוח Server-side

סקירה כללית
Plugin
Collections טבלאות נתונים
Database: פעולות
DataSourceManager - ניהול מקורות נתונים
ResourceManager
ACL בקרת הרשאות
Middleware
Cache
Event
Context - הקשר בקשה
Migration סקריפט שדרוג
Logger יומן
Telemetry
I18n בינאום
Command
CronJobManager ניהול משימות מתוזמנות
Test

פיתוח Client-side

סקירה כללית
Plugin
Context
Router ניתוב
ACL בקרת הרשאות
DataSourceManager - ניהול מקורות נתונים
Resource
Request
Styles & Themes
Logger יומן
I18n בינאום
Test

אחר

מדריך שדרוג Plugin
רשימת שפות
ניהול תלויות
בנייה
Previous PageLogger יומן
Next PageI18n בינאום
TIP

מסמך זה תורגם על ידי בינה מלאכותית. לכל אי דיוק, אנא עיין בגרסה האנגלית

#טלמטריה

ניסיוני

מודול הטלמטריה של 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