پرش به مطلب اصلی

تنظیمات ارسال log

برای ارسال لاگ های ایجاد شده توسط سیستم نرم افزاری خودتان، میتوانید یکی از دو روش زیر را انتخاب کنید.

۱. خواندن خودکار فایل لاگ توسط opentelemetry-collector (روش پیشنهادی)​

در این روش، سیستم نرم افزاری شما در حال ایجاد لاگ و ذخیره آن بر روی فایل بر روی سیستم عامل میباشد. سپس، شما میتوانید opentelemetry-collector را به صورتی تنظیم کنید تا به صورت خودکار مسیر فایل دلخواه را پایش کرده و اطلاعات دریافتی از فایل لاگ را به سمت لاگ نگار ارسال کند.

نکته: این روش میتواند سربار ارسال لاگ را از دوش سرویس های نرم افزاری شما برداشته و به عملکرد بهتر سیستم شما کمک کند.

تنطیمات مورد نیاز:

receivers:
  filelog:
    include:
      - /var/log/*.log

processors:
  batch:
    timeout: 10s
exporters:
  otlphttp/logs:
    endpoint: https://api.lognegar.ir/api
    headers:
      lognegar-api-key: "LOGNEGAR-API-KEY"
    retry_on_failure:
      enabled: true
      initial_interval: 5s
      max_interval: 30s
      max_elapsed_time: 600s
service:
  pipelines:
    logs:
      receivers: [filelog]
      processors: [batch]
      exporters: [otlphttp/logs]

۲. ارسال مستقیم لاگ به opentelemetry-collector​

سرویس openetelemetry-collector ، بر روی دو پرتوکل http و grpc میتواند اطلاعات لاگ را دریافت کند. بدین ترتیب، شما بایستی در سیستم نرم افزاری خود (تغیرات سمت کد)، از پکیچ و sdk مورد نظر استفاده کرده و اطلاعات لاگ را به سمت opentelemetry-collector ارسال کنید. بدین منظور، لطفا مراحل زیر را طی کنید:

۱. ابتدا برای اتصال اپلیکیشن های خود میتوانید از راهنمای لاگ نگار برای زبان های برنامه نویسی، فریمورک ها و کتابخانه های مختلف استفاده کنید:

NodeJS - Go python

نکته: برای اتصال اپلیکیشن های دیگر میتوانید از این مستندات استفاده کنید

۲. سپس تنظیمات زیر را بر روی سرویس opentelemetry-collector اعمال کنید:

receivers:
  otlp:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
      grpc:
        endpoint: 0.0.0.0:4317
processors:
  batch:
    timeout: 10s
exporters:
  otlphttp/logs:
    endpoint: https://api.lognegar.ir/api
    headers:
      lognegar-api-key: "LOGNEGAR-API-KEY"
    retry_on_failure:
      enabled: true
      initial_interval: 5s
      max_interval: 30s
      max_elapsed_time: 600s
service:
  pipelines:
    logs:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/logs]