پروفایل‌گیری پیوسته

پروفایل‌گیری پیوسته نشان می‌دهد برنامهٔ شما زمان پردازنده و حافظه را تابع به تابع چگونه مصرف می‌کند. Status200 یک API دریافت سازگار با Pyroscope ارائه می‌دهد، پس هر چیزی که بتواند به یک سرور Pyroscope داده بفرستد — پروفایلر eBPF در Grafana Alloy یا یک SDK زبانی Pyroscope — می‌تواند به Status200 هم بفرستد، و نتیجه را به‌صورت نمودار شعله کنار لاگ‌ها، متریک‌ها و ترِیس‌هایتان می‌خوانید.

چگونه کار می‌کند#

یک پروفایلر از فرایندهای شما نمونه می‌گیرد و هر چند ثانیه یک پروفایل را با کلید دریافت داده‌تان به نقطهٔ پایانی /pyroscope در Status200 بارگذاری می‌کند. Status200 هر پروفایل را زیر سرویسی که نام می‌برد ذخیره می‌کند و آن را به‌صورت نمودار شعله در پروفایل‌های کارایی نمایش می‌دهد.

پیش از شروع#

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

1. کلیدهای دریافت داده را باز کنید#

   به محصولات → تنظیمات پروژه بروید، در منوی کناری تله‌متری و APM را باز کنید و کلیدهای دریافت داده را برگزینید.

   

2. یک کلید بسازید#

   روی ساخت کلید دریافت داده کلیک کنید. پنجره نام کلید را پر کرده و سرور را برگزیده است — نوع کلیدی که برنامه‌ها و جمع‌کننده‌ها با آن داده می‌فرستند — پس برای ساختن آن روی ساخت کلید دریافت داده کلیک کنید، یا نخست نامش را عوض کنید.

3. کلید محرمانه را کپی کنید#

   کلید تازه در صفحهٔ خودش باز می‌شود. کلید محرمانه آن را کپی کنید: این همان توکن دریافت داده است که نمونه‌های زیر YOUR_STATUS200_INGESTION_TOKEN می‌نامند.

   

نقطهٔ پایانی دریافت#

کلاینت‌ها مسیر خودشان را به نشانی پایه می‌افزایند — /ingest برای بیشتر SDKهای Pyroscope، و /push.v1.PusherService/Push برای Grafana Alloy و SDK داتنت از v0.14 به بعد — پس همیشه فقط نشانی پایه را، بدون اسلش پایانی، پیکربندی می‌کنید.

Status200 توکن دریافت داده را از هرکدام از این‌ها می‌خواند، پس هرکدام را که کلاینتتان پشتیبانی می‌کند به کار ببرید:

قالب‌های پروفایل پشتیبانی‌شده#

ارسال پروفایل‌ها#

Grafana Alloy هر فرایند روی یک میزبان را بدون تغییر کد پروفایل می‌کند و راه پیشنهادی برای شروع است. در مقابل، SDK از Pyroscope درون برنامهٔ شما اجرا می‌شود.

discovery.process "all" {
  refresh_interval = "60s"
}

discovery.relabel "alloy_profiles" {
  targets = discovery.process.all.targets

  rule {
    action       = "replace"
    source_labels = ["__meta_process_exe"]
    target_label  = "service_name"
  }
}

pyroscope.ebpf "default" {
  targets    = discovery.relabel.alloy_profiles.output
  forward_to = [pyroscope.write.status200.receiver]

  collect_interval = "15s"
  sample_rate      = 97
}

pyroscope.write "oneuptime" {
  endpoint {
    url = "https://status200.ru/pyroscope"
    headers = {
      "x-status200-token" = "YOUR_STATUS200_INGESTION_TOKEN",
    }
  }
}

services:
  alloy:
    image: grafana/alloy:latest
    privileged: true
    pid: host
    volumes:
      - ./alloy-config.alloy:/etc/alloy/config.alloy
      - /proc:/proc:ro
      - /sys:/sys:ro
    command:
      - run
      - /etc/alloy/config.alloy

alloy run alloy-config.alloy

import "github.com/grafana/pyroscope-go"

pyroscope.Start(pyroscope.Config{
    ApplicationName: "my-service",
    ServerAddress:   "https://status200.ru/pyroscope",
    AuthToken:       "YOUR_STATUS200_INGESTION_TOKEN",
    ProfileTypes: []pyroscope.ProfileType{
        pyroscope.ProfileCPU,
        pyroscope.ProfileAllocObjects,
        pyroscope.ProfileAllocSpace,
        pyroscope.ProfileInuseObjects,
        pyroscope.ProfileInuseSpace,
        pyroscope.ProfileGoroutines,
    },
})

const Pyroscope = require("@pyroscope/nodejs");

Pyroscope.init({
  serverAddress: "https://status200.ru/pyroscope",
  appName: "my-service",
  authToken: "YOUR_STATUS200_INGESTION_TOKEN",
});

Pyroscope.start();

import pyroscope

pyroscope.configure(
    application_name="my-service",
    server_address="https://status200.ru/pyroscope",
    auth_token="YOUR_STATUS200_INGESTION_TOKEN",
)

FROM alpine:3.20 AS pyroscope-profiler
ARG PYROSCOPE_DOTNET_VERSION=1.5.1
ADD https://github.com/grafana/pyroscope-dotnet/releases/download/pyroscope-${PYROSCOPE_DOTNET_VERSION}/pyroscope.${PYROSCOPE_DOTNET_VERSION}-glibc-x86_64.tar.gz /tmp/pyroscope.tar.gz
RUN mkdir -p /pyroscope && tar -xzf /tmp/pyroscope.tar.gz -C /pyroscope

FROM mcr.microsoft.com/dotnet/aspnet:10.0
# ... your application ...
COPY --from=pyroscope-profiler /pyroscope /pyroscope
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={BD1A650D-AC5D-4896-B64F-D6FA25D6B26A}
ENV CORECLR_PROFILER_PATH=/pyroscope/Pyroscope.Profiler.Native.so
ENV LD_PRELOAD=/pyroscope/Pyroscope.Linux.ApiWrapper.x64.so
ENV LD_LIBRARY_PATH=/pyroscope

PYROSCOPE_APPLICATION_NAME=my-service
PYROSCOPE_PROFILING_ENABLED=1
PYROSCOPE_SERVER_ADDRESS=https://status200.ru/pyroscope
PYROSCOPE_BASIC_AUTH_USER=oneuptime
PYROSCOPE_BASIC_AUTH_PASSWORD=YOUR_STATUS200_INGESTION_TOKEN

Ruby و Rust مانند Go، Node.js و Python کار می‌کنند: SDK زبان خود از Pyroscope را نصب کنید و نشانی سرور را روی https://status200.ru/pyroscope بگذارید، با توکن دریافت داده به‌عنوان توکن احراز هویت (یا اگر نسخهٔ SDK شما فقط احراز هویت پایه را ارائه می‌دهد، به‌عنوان گذرواژهٔ احراز هویت پایه).

انواع پروفایل پشتیبانی‌شده#

یک pprof می‌تواند چند نوع نمونه اعلام کند؛ هر پروفایل بارگذاری‌شده زیر یکی از آن‌ها ذخیره می‌شود — زمان پردازنده (cpu به نانوثانیه) اگر داشته باشد، وگرنه زمان دیواری، وگرنه بایت‌های در حال استفاده و سپس بایت‌های تخصیص‌یافته، وگرنه نخستین نوعی که اعلام کرده است. هر نوعی ذخیره می‌شود و قابل مشاهده است؛ نوع‌های زیر در رابط Status200 گروه‌بندی، واحد و برچسب درجه‌یک دارند:

هر چیز دیگری (برای نمونه یک نوع نمونهٔ سفارشی) با نام خامش زیر «دیگر» نمایش داده می‌شود.

بررسی درستی کار#

1. توکن خود را بررسی کنید#

   نقطه‌های پایانی دریافت به توکنِ غایب یا نامعتبر با 401 پاسخ می‌دهند، اما بیشتر پروفایلرها آن را جایی که ببینید نشان نمی‌دهند (برای نمونه پروفایلر داتنت پاسخ‌های HTTP را فقط در سطح debug ثبت می‌کند). مستقیم از نقطهٔ پایانی اعتبارسنجی بپرسید:

   Bash

   curl -i -H "x-status200-token: YOUR_STATUS200_INGESTION_TOKEN" \
     https://status200.ru/otlp/v1/validate

   توکن معتبر 200 را با {"valid": true, ...} برمی‌گرداند، و keyType آن باید Server باشد: کلید مرورگر هم معتبر است، اما نمی‌تواند پروفایل بفرستد. توکن ناشناخته، باطل‌شده، غیرفعال یا منقضی 401 برمی‌گرداند.

2. صفحهٔ پروفایل‌ها را باز کنید#

   در داشبورد Status200 به محصولات → پروفایل‌های کارایی بروید. با فاصلهٔ جمع‌آوری ۱۵ ثانیه‌ای Alloy (یا فاصلهٔ بارگذاری ۱۰ تا ۱۵ ثانیه‌ای SDKها)، نخستین پروفایل‌ها و نمودارهای شعلهٔ آن‌ها ظرف یکی دو دقیقه پس از شروع عامل ظاهر می‌شوند.

3. سرویس را بررسی کنید#

   پروفایل‌ها به سرویس تله‌متری‌ای پیوست می‌شوند که application_name / appName / PYROSCOPE_APPLICATION_NAME در SDK نام می‌برد (یا در قاعدهٔ relabel بالا در Alloy، نام فایل اجرایی فرایند).

4. هنوز چیزی نیست؟ وضعیت بارگذاری را ببینید#

   برای پروفایلر داتنت، DD_TRACE_DEBUG=1 را یک دقیقه روی برنامه تنظیم کنید: سپس برای هر بارگذاری یک خط PyroscopePprofSink <status> ثبت می‌کند. 200 یعنی Status200 آن را پذیرفته است؛ 401 مشکل توکن است؛ 404 معمولاً یعنی PYROSCOPE_SERVER_ADDRESS پسوند /pyroscope را ندارد؛ 413 یعنی پراکسی‌ای جلوی Status200 اندازهٔ بارگذاری را رد کرده است (زبانهٔ .NET را در ارسال پروفایل‌ها ببینید). اگر Status200 را خودتان اجرا می‌کنید، لاگ دسترسی ورودی (nginx) هم همان وضعیت را برای هر درخواست /pyroscope ثبت می‌کند.

کاوش پروفایل‌ها در Status200#

محصولات → پروفایل‌های کارایی پروفایلر را روی نمای کلی آن باز می‌کند. پیش از هر نموداری با کلمات پاسخ می‌دهد: زمان کجا می‌رود («در checkout، ۴۲٪ از زمان پردازنده صرف JSON.parse شد.») و، وقتی پرکارترین تابع از آنِ یک کتابخانه یا محیط اجراست، تابعی از کد خود شما که بیشترین سهم را دارد، همراه با کد کتابخانه و محیط اجرایی که فراخوانی می‌کند. در بالا یک سرویس، نوعی از پروفایل که آن سرویس برایش داده دارد (زمان پردازنده، زمان دیواری، حافظه، تخصیص‌ها، قفل‌ها یا Goroutineها، یا یک نوع زیر انواع دیگر پروفایل) و یک بازه را برگزینید.

مقایسهٔ دو بازه#

مقایسه با تعیین می‌کند بازه با چه چیزی مقایسه شود: دورهٔ قبل، همین زمان در دیروز، همین زمان در هفتهٔ گذشته، یا یک استقرار زیر قبل و بعد از یک تغییر. سهم‌ها مقایسه می‌شوند نه مجموع‌ها، پس افزایش ترافیک به‌تنهایی چیزی را جابه‌جا نمی‌کند. عنوان، تابعی را که سهمش بیش از همه رشد کرده و کد خود شما را که رشد کرده نام می‌برد؛ نمودار شعله به چه چیزی تغییر کرد تبدیل می‌شود، که در آن قاب‌های قرمز پس از تغییر سهم بیشتری دارند و قاب‌های سبز سهم کمتری؛ و تابع‌هایی که تغییر کردند سهم هر تابع را قبل و بعد فهرست می‌کند.

یک تابع#

روی یک تابع کلیک کنید تا پنل آن باز شود: سهمش به‌صورت خودی، کل و کد شما، چه چیزی آن را فراخوانی می‌کند و چه چیزی را فراخوانی می‌کند، پیوندی به فایل و خط آن در مخزن شما وقتی مخزنی وصل است، و برجسته کردن در نمودار شعله. برای تابعی از یک کتابخانه یا محیط اجرا، پنل تابعی از کد خود شما را که آن را فراخوانی می‌کند نام می‌برد، جایی که تغییری می‌تواند آن را کم‌هزینه‌تر کند. پیوندی زیر سهم‌ها برای سهم تابع، بالاتر از سهم امروزش، هشدار تنظیم می‌کند: مانیتور پروفایل‌ها را ببینید.

وقتی تابعی از کد خود شما دست‌کم ۵٪ از زمان یا حافظهٔ پروفایل را می‌گیرد، یا سهمش نسبت به بازه‌ای که با آن مقایسه می‌شود ۳ واحد یا بیشتر رشد کرده است، پنل رفع با هوش مصنوعی را پیشنهاد می‌دهد: Status200 AI در مخزنی که تابع را در خود دارد کاری را آغاز می‌کند، با پروفایل به‌عنوان شاهد، و یک درخواست ادغام برای بازبینی شما باز می‌کند (Code را ببینید). Status200 AI در پاسخ‌ها و بررسی‌هایش هم پروفایل‌ها را می‌خواند، پس می‌توانید از آن بپرسید کدام تابع‌ها بیشترین زمان پردازنده را مصرف می‌کنند.

یک پروفایل#

همه پروفایل‌ها هر بارگذاری را فهرست می‌کند. صفحهٔ یک پروفایل سه نما دارد:

Download pprof پروفایل را برای ابزارهای محلی مانند go tool pprof ذخیره می‌کند.

هم‌بستگی با ترِیس#

وقتی یک پروفایل شناسه‌های ترِیس و span را با خود دارد (برای نمونه به‌صورت برچسب‌های نمونهٔ trace_id / span_id)، می‌توانید از یک span کند در ترِیس مستقیم به پروفایل پردازنده یا حافظهٔ متناظر بروید تا دقیقاً بفهمید چه کدی در حال اجرا بوده است، و Open linked trace مسیر برعکس را می‌رود.

زبانهٔ پروفایل یک span نمونه‌های پیوندشده به spanهای تودرتوی زیر آن را هم دربر دارد، چون پروفایلرها اغلب زمان پردازندهٔ یک درخواست را به یک span فرزند نسبت می‌دهند، نه به خود span درخواست.

صفحهٔ یک ترِیس، اگر سرویس آن در همان زمان پروفایل می‌شد، به پروفایلرِ سرویس ترِیس برای ۱۵ دقیقه پیش و پس از آن هم پیوند می‌دهد، و صفحهٔ پروفایل‌های کارایی یک سرویس یا میزبان پروفایلر را روی همان سرویس یا میزبان باز می‌کند.

نگهداری داده#

پروفایل‌ها به اندازهٔ دورهٔ نگهداری تله‌متری پروژهٔ شما نگه داشته می‌شوند: تنظیمات پروژه → تله‌متری و APM → نگهداری داده مقدار نگهداری پیش‌فرض (روز) را تعیین می‌کند، که اگر تغییرش ندهید ۱۵ روز است. داده‌ها با پایان دورهٔ نگهداری خودکار حذف می‌شوند. پلن‌هایی که بازنویسی نگهداری را دارند می‌توانند پروفایل‌ها را بیشتر یا کمتر از دیگر تله‌متری نگه دارند، یا نگهداری را برای هر سرویس در صفحهٔ تنظیمات آن سرویس تعیین کنند.

گام‌های بعدی#