LABELS.CONF(5) File Formats Manual LABELS.CONF(5)

labels.conf - پیکربندی برچسب‌های Performance Co-Pilot

/etc/pcp/labels.conf

چندین ابزار و برنامه کمکی Performance Co-Pilot (PCP) از برچسب‌های متریک پشتیبانی می‌کنند. این قابلیت، همان‌طور که در pmLookupLabels(3) شرح داده شده است، مجموعه‌ای سلسله‌مراتبی از برچسب‌ها را به هر نمونه از هر متریک اعمال می‌کند.

دیمن‌های pmcd(1) و pmproxy(1) اهمیت ویژه‌ای در سامانه برچسب‌ها دارند؛ به این صورت که به ترتیب برچسب‌ها را به‌صورت بلادرنگ (real-time) فراهم می‌کنند و سپس برچسب‌های ضبط‌شده (آرشیو) را شناسایی کرده و آن‌ها را برای پرس‌وجوهای pmseries(1) با استفاده از یک سرویس کلید-مقدار توزیع‌شده مانند https://valkey.io نمایه‌گذاری (ایندکس) می‌نمایند.

فایل /etc/pcp/labels.conf یک نقطه پیکربندی یکتا برای رفتاری است که بر تمامی برچسب‌های صادرشده توسط pmcd یا از طریق ابزارهایی که از سرویس‌های زمینه محلی PMAPI استفاده می‌کنند، اثر می‌گذارد. این فایل از قالب رایج «ini» استفاده می‌کند و هر متغیری که در آن مشخص شود و درون یک بخش صریح محصور در قلاب (کروشه) قرار نگرفته باشد، یک متغیر [global] در نظر گرفته می‌شود.

متغیرهای پیکربندی در دسترس به شرح زیر است :

هنگامی که در بخش [global] مشخص شود، نحوه برون‌ریزی machine-id(5) محلی را به عنوان برچسب کنترل می‌کند. تنظیم پیش‌فرض (none) یک برچسب بافتار "machineid" با مقداری که بازتاب‌دهنده محتویات فایل /etc/machine-id است، روی تمام پلتفرم‌هایی که این فایل را ارائه می‌دهند برون‌ریزی می‌کند. حالت جایگزین (sha256) در عوض یک برچسب "machineid_sha256" برون‌ریزی می‌کند که مقدار آن هش SHA256 (یک‌طرفه) فایل است.

pmcd(1), pmproxy(1), pmseries(1), PMAPI(3), pmLookupLabels(3) و machine-id(5).

PCP Performance Co-Pilot