انتقل إلى المحتوى
NanoFlags
ابدأ مجانًا

حِزم SDK

SDK ‏Ruby

تقيّم الجوهرة nanoflags الأعلام محليًا وبشكل متزامن على إعداد موقّع في الذاكرة، وتُبقيه خيوطٌ في الخلفية محدّثًا، والعميل آمن مع تعدد الخيوط ومع التفرّع (fork). واستدعاء القراءة لا يُجري أي عملية إدخال/إخراج ولا يرفع استثناءً أبدًا.

التثبيت

Gemfile
gem "nanoflags"
gem "nanoflags-openfeature"   # optional: OpenFeature provider
  • منشورة على RubyGems باسم nanoflags 0.2.0 وnanoflags-openfeature 0.2.0. تتطلب Ruby 3.1 أو أحدث.
  • بلا اعتماديات وقت التشغيل: Net::HTTP والمقابس (sockets) وOpenSSL ‏(Ed25519) وJSON من المكتبة القياسية. وعميل WebSocket للتحديثات الحيّة تنفيذ صغير مدمج لمعيار RFC 6455.
  • المحرك نقلٌ أصلي لمحرك NanoFlags، مختبَر على الحالات المشتركة المولَّدة من المحرك المرجعي (21,998 حالة تقييم)، فيعطي النتائج نفسها التي تعطيها كل حزم SDK الأخرى.
  • برخصة Apache-2.0. والشيفرة المصدرية في nanoflags-sdk/ruby.

البدء السريع

انسخ مفتاح خادم (nf_srv_…) من الإعدادات ← مفاتيح SDK (Settings → SDK keys) في لوحة التحكم واحفظه في متغير بيئة. ومرّر on_error: إلى المُنشئ ليُسجَّل قبل بدء التحميل الأول، ثم انتظر الجاهزية.

app.rb
require "nanoflags"

FLAGS = NanoFlags::Client.new(
  ENV.fetch("NANOFLAGS_SDK_KEY"),   # nf_srv_… (server view) or nf_pub_… (client-exposed flags only)
  service: "checkout-api",          # shown in "which revision is each service running"
  on_error: ->(e) { warn "nanoflags #{e.code}: #{e.message}" }
)
FLAGS.wait_until_ready(5)           # never raises; true once a configuration is in use

user = { key: current_user.id.to_s, plan: current_user.plan, country: "DE" }
if FLAGS.bool_variation("new-checkout", false, user)
  # …
end
  • أنشئ عميلًا واحدًا لكل عملية وشاركه بين الخيوط. والعنوان الأساسي افتراضيًا هو الحافة المستضافة https://edge.nanoflags.io.
  • السياق Hash من خصائص شبيهة بـ JSON (بمفاتيح String أو Symbol؛ وتتحول Time وDate إلى نصوص ISO 8601). وkey هو الهوية الثابتة المستخدمة في الطرح بالنسب المئوية.
  • يتلقى المسجّل الذي تمرّره في logger: تشخيصات العميل بمستوى debug، ويحمل last_error دائمًا آخر خطأ.

القراءات المُنمَّطة والتفاصيل

ruby
enabled = FLAGS.bool_variation("new-checkout", false, user)
accent  = FLAGS.string_variation("accent", "blue", user)
limit   = FLAGS.number_variation("rate-limit", 100, user)        # Integer for whole numbers, else Float
layout  = FLAGS.json_variation("layout", { "cols" => 3 }, user)  # Hash with String keys
every   = FLAGS.all_flags(user)                                  # no telemetry

d = FLAGS.bool_variation_detail("new-checkout", false, user)
d.value     # => true
d.reason    # => "rule_match"
d.rule_id   # => "beta"
d.revision  # => 57
d.trace     # the same steps the dashboard shows
الحقلالمعنى
valueالقيمة المقدَّمة (قيمتك الافتراضية في حالات الاحتياط).
reason"rule_match"، "default" (لم تطابق قاعدة)، "off" (العلم معطّل)، "flag_not_found"، "error" (نوع خاطئ أو إعداد مشوّه)
rule_index · rule_idالقاعدة المطابقة (فهرس يبدأ من الصفر)، أو nil.
in_rollout · bucketللطرح بالنسب المئوية: هل المفتاح داخل التوزيع، وشريحته (من 0 إلى 99.99).
revisionنسخة الإعداد التي جاءت منها النتيجة.
traceقائمة من NanoFlags::Engine::TraceStep تشرح القرار خطوة بخطوة.
error · json · type_nameلماذا كان reason هو "error"؛ والقيمة الخام كنص JSON واسم نوعها.

كل دالة قراءة تأخذ مفتاح العلم والقيمة الافتراضية وسياقًا اختياريًا. وتحصل على قيمتك الافتراضية عندما لم يُحمَّل إعداد بعد، أو عندما يكون العلم مجهولًا، أو عندما يقدّم قيمة من نوع آخر. والعلم المعطّل ليس حالة احتياط: فهو يعيد قيمة off المضبوطة له. وتعيد evaluate(key, default, context) نتيجة المحرك دون فحص للنوع.

التحديثات الحيّة والمستمعات

يُبقي العميل اتصال WebSocket واحدًا بنقطة الحافة /v1/live مفتوحًا (بالبروتوكول الفرعي nanoflags.v1، وينتقل المفتاح في ترويسة Authorization، لا في العنوان أبدًا)، وهو البروتوكول نفسه الذي تستخدمه حزم JavaScript وPython وGo وJava. ترسل الحافة الحزمة الحالية عند الاتصال، ثم كل نسخة جديدة فور نشرها. ويُتحقَّق من كل حزمة مدفوعة تمامًا كالحزمة المجلوبة قبل استبدالها ذرّيًا، فيرى التقييم دائمًا نسخة واحدة كاملة؛ والحزمة المدفوعة التي لا تجتاز التحقق لا تغيّر شيئًا، وتستدعي طلبًا عاديًا بدلًا منها.

ruby
off = FLAGS.on_change { |e| puts "now on r#{e.revision} (was r#{e.previous_revision}) via #{e.transport}" }
FLAGS.on(:status) { |status| puts "nanoflags status: #{status}" }   # "not-ready", "ready" or "stale"

off.call   # unsubscribe
الحقلالمعنى
revision · previous_revisionالنسخة الجديدة والنسخة التي حلّت محلها (nil للأولى).
checksumالمجموع الاختباري للإعداد الجديد.
source:network أو :store أو :bootstrap
transport:live (دُفعت عبر WebSocket) أو :stream (جُلبت بعد إشعار من تدفق الأحداث) أو :poll
latency_msللنسخ المدفوعة التي تحمل وقت اعتمادها: المدة بالمللي ثانية من اعتماد قاعدة البيانات حتى هذا الحدث؛ وإلا فـ nil.
  • تعمل المستمعات على خيوط الخلفية التابعة للعميل: اجعلها قصيرة. والاستثناء داخل مستمع يُسجَّل ولا يعطّل العميل أبدًا. وتعيد on(:change | :error | :status) وon_change وon_error دالة lambda لإلغاء الاشتراك.
  • يكشف ping نصّي كل 30 ثانية تقريبًا الاتصالات الميتة، ويُستبدل المقبس بعد نحو 50 دقيقة. وتتباعد محاولات إعادة الاتصال 1 ثم 2 ثم 4 ثوانٍ وهكذا حتى 5 دقائق. وما دام المقبس سليمًا لا يعمل الاستطلاع إلا كل live_poll_interval ‏(300 ثانية) كشبكة أمان. ويتخطى live: false المقبس.
  • يعني رمز الإغلاق 4004 أن بيئة المفتاح حُذفت: يبقى آخر إعداد قيد الاستخدام، وتصبح status بقيمة "stale"، ويتلقى on_error الرمز :environment_deleted، ويتوقف العميل عن إعادة الاتصال.
  • البديل. ما دام تعذّر فتح مقبس (وسيط يرفض الترقية مثلًا)، يُبقي العميل تدفق الأحداث GET /v1/stream مفتوحًا: كل حدث revision يجعله يجلب /v1/bundle مع If-None-Match، ويتحقق من الحزمة ويستبدلها. ويلتقط الاستطلاع كل poll_interval ‏(30 ثانية؛ و0 يعطّله) ما قد يفوتهما معًا. وبعد الأعطال يعيد المحاولة بعد 1 ثم 2 ثم 4 ثوانٍ وهكذا حتى فترة الاستطلاع؛ وتتباعد محاولات إعادة اتصال التدفق حتى 30 ثانية. ويستخدم streaming: false الاستطلاع وحده.

الجاهزية والحالة

ruby
unless FLAGS.wait_until_ready(5)
  Rails.logger.warn("flags not loaded yet (#{FLAGS.last_error&.message}); variations return their defaults")
end

FLAGS.status        # "not-ready" | "ready" | "stale"
FLAGS.revision      # revision in use, or nil
FLAGS.transport     # :live | :stream | :poll
FLAGS.initialized?  # true once a configuration is in use
  • تنتظر wait_until_ready(timeout) حتى يصبح إعداد قيد الاستخدام أو تفشل محاولة التحميل الأولى، لمدة timeout ثانية على الأكثر (وnil: بلا حد). ولا ترفع استثناءً أبدًا.
  • "ready": الإعداد معروف أنه محدّث. "stale": هناك إعداد قيد الاستخدام لكن لا يُعرف أنه محدّث. "not-ready": لم يُحمَّل شيء، وكل قراءة تعيد قيمتها الافتراضية.
  • لا تجعل أي طلب ينتظر الجاهزية. انتظر مرة واحدة عند الإقلاع بمهلة قصيرة، ودع قيمك الافتراضية تغطي الباقي.

Puma وUnicorn والأمان عند التفرّع

العميل آمن عند التفرّع (Puma وUnicorn وPassenger وResque وSidekiq Swarm). يحتفظ العامل المتفرّع بالإعداد الذي ورثه، فيستطيع التقييم فورًا، وعند أول استدعاء يعيد تشغيل خيوط الخلفية الخاصة به ويفتح مقبسه الحي الخاص؛ ولا يُمسّ اتصال العملية الأم أبدًا. والأحداث المنتظرة قبل التفرّع لا ترسلها إلا العملية الأم، وتُورَث جلسات الاختبار المخزّنة مؤقتًا.

config/puma.rb
preload_app!

on_worker_boot { NanoFlags::Client.after_fork }   # start each worker's threads right away
  • تعيد NanoFlags::Client.after_fork تشغيل خيوط الخلفية لكل عميل في العملية الابنة فورًا. وهي اختيارية: من دونها يلاحظ العميل التفرّع عند أول استدعاء فيعيد التشغيل حينها.
  • مع preload_app! لا بأس بإنشاء العميل في العملية الرئيسية. وإن كان يجب ألا تفتح العملية الرئيسية أي اتصال، فمرّر هناك start: false واستدعِ FLAGS.start داخل on_worker_boot: فالعميل المنشأ بـ start: false لا يبدأ إلا حين تُستدعى start.
  • مع Unicorn: استدعِ NanoFlags::Client.after_fork من after_fork في config/unicorn.rb.

Rails وSidekiq

config/initializers/nanoflags.rb
Rails.application.config.after_initialize do
  NANOFLAGS = NanoFlags::Client.new(
    Rails.application.credentials.nanoflags_sdk_key,
    service: "web",
    cache_path: Rails.root.join("tmp/nanoflags.json"),   # optional: start from the last good bundle
    logger: Rails.logger
  )
end

يستخدم Sidekiq وغيره من العمّال متعددي الخيوط العميلَ نفسه على مستوى العملية في كل مهمة؛ والتقييمات قراءات بلا أقفال للحزمة الحالية. ولا تستدعِ close عند الإيقاف إلا إن احتجت إلى إرسال القياس الأخير بشكل متزامن: فخطاف at_exit يفعل ذلك أيضًا.

جلسات الاختبار

تثبّت جلسة الاختبار المشتركة (بالإنجليزية)، التي تُنشأ في لوحة التحكم (السيناريوهات ← جلسة اختبار مشتركة، Scenarios → Shared test session)، لقطةً من الإعداد وسياقًا اصطناعيًا على رمز (nf_ts_…). والخدمة التي تتلقى الرمز في ترويسة x-nanoflags-session تقيّم على تلك اللقطة، بالسياق session.context.merge(your_context)، لذلك الطلب وحده. وتحمل الأحداث المأخوذة كعيّنة من جلسة معرّفَها. وجلسات الاختبار المشتركة جزء من خطة Scale.

config/application.rb
# any Rack app: use NanoFlags::SessionMiddleware, FLAGS
config.middleware.use NanoFlags::SessionMiddleware, FLAGS   # reads x-nanoflags-session, resolves it once per request
ruby
# a controller
flags = request.env["nanoflags.flags"]            # or NanoFlags.flags_for(FLAGS) where there is no request
flags.bool_variation("checkout-v2", false, { key: current_user.id })   # session-scoped while the session is active
flags.active?                                    # false when unknown, expired, revoked or not permitted here

# downstream calls join the session ({} outside one, always safe to merge)
Faraday.get(PRICING_URL, nil, NanoFlags.session_headers)

# jobs: pass the token along and resolve it in the worker
PriceJob.perform_async(order.id, NanoFlags.current_session)
NanoFlags.with_session(token) { NanoFlags.flags_for(FLAGS).bool_variation("checkout-v2", false, { key: user_id }) }

# or directly
s = FLAGS.session(request.headers["x-nanoflags-session"], service: "checkout-api")
s.id; s.expires_at; s.revision
  • تسأل FLAGS.session(token, service:) الحافة مرة واحدة لكل رمز وخدمة (GET /v1/session، والرمز في X-NanoFlags-Session، وservice في X-NanoFlags-Service، وافتراضيًا service الخاصة بالعميل)، وتخزّن الجواب مؤقتًا حتى تنتهي الجلسة. وتُتذكَّر الرموز المجهولة 15 ثانية، وعمليات البحث الفاشلة 3 ثوانٍ (أخطاء :session). والطلبات المتزامنة بالرمز الجديد نفسه تنتظر بحثًا واحدًا.
  • لا ترفع استثناءً أبدًا. والرمز المجهول أو المنتهي أو الملغى أو غير المسموح به يعود إلى الإعداد العادي: يتصرّف المقيّم تمامًا كالعميل، فيخدم مسار شيفرة واحد الحركة العادية والاختبارات. وإن انتهت الجلسة أثناء الطلب تصبح active? خاطئة وتستمر التقييمات على الإعداد المنشور.
  • تعيش الجلسة الحالية في تخزين الألياف (Fiber[]، وترثها الخيوط والألياف التي تبدأ داخلها في Ruby 3.2 فأحدث؛ ومحلية للليف في 3.1). ولا يُخزَّن شيء على العميل. وتنتهي جلسة الوسيط عندما تعود call.
  • تغيّر الجلسة اللقطة والسياق اللذين يستخدمهما التقييم فقط. فهي لا تمنح أي وصول إلى البيانات ولا يجوز استخدامها للتفويض. ولا تتلقى مفاتيح العميل إلا الأعلام المكشوفة للعميل، في الجلسات أيضًا. وحزم الجلسات غير موقّعة، فلا ينطبق عليها التحقق. والجلسة الملغاة تظل تعمل في عملية خزّنتها مؤقتًا حتى تنتهي.
الواجهةالوصف
session(token, service: nil)تعيد NanoFlags::SessionEvaluator: القراءات المُنمَّطة وتفاصيلها، وevaluate وactive? وid وexpires_at وrevision.
NanoFlags::SessionMiddlewareوسيط Rack: يضبط env["nanoflags.flags"] ويشغّل بقية الطلب داخل الجلسة.
NanoFlags.with_session(token) { … }تشغّل الكتلة والرمز هو الجلسة الحالية. والرمز الغائب أو المشوّه يشغّلها خارج أي جلسة.
NanoFlags.flags_for(client)مقيّم الطلب الحالي، يُحلّ مرة واحدة لكل طلب وعميل؛ وخارج الجلسة يتصرّف كالعميل.
NanoFlags.current_session · NanoFlags.session_headersالرمز الحالي (أو nil)؛ و{ "x-nanoflags-session" => token } داخل الجلسة، وإلا {}.
NanoFlags::SESSION_HEADER"x-nanoflags-session"

آخر إعداد سليم والتهيئة المسبقة

بعد التحميل يبقى آخر إعداد سليم قيد الاستخدام رغم أعطال الشبكة والحزم المرفوضة وأخطاء الحافة (فتصبح status بقيمة "stale").

ruby
FLAGS = NanoFlags::Client.new(sdk_key, cache_path: "tmp/flags.json")                  # keep the last good bundle
FLAGS = NanoFlags::Client.new(sdk_key, store: NanoFlags::Store::Cache.new(Rails.cache))  # share it through an ActiveSupport cache
FLAGS = NanoFlags::Client.new(sdk_key, bootstrap: File.read("flags-bootstrap.json"))    # serve a bundle you ship until the edge answers
  • يكتب cache_path ذرّيًا بالصلاحية 0600، ويستعيد الحزمة عند البدء بحالة "stale" حتى تؤكدها الحافة. ويُتحقَّق من النسخة المستعادة مجددًا، وتُتجاهل إن لم تجتز التحقق.
  • يأخذ store: أي كائن له get وset(text). ويأخذ bootstrap: قيمة Hash أو نص JSON.
  • تحمل الذاكرة المؤقتة قواعد الأعلام، ولا تحمل مفتاح الـ SDK أبدًا.

التحقق من التوقيع

تُفحص كل حزمة (‏Ed25519 على السلسلة المعيارية، حسب معرّف المفتاح) قبل أن تحلّ محل الحالية. ومع الحافة المستضافة يكون ذلك مفعّلًا افتراضيًا بمفاتيح الإنتاج المضمّنة في الجوهرة (NanoFlags::OFFICIAL_SIGNING_KEYS)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة الخام كما قُدّمت تمامًا.

ruby
# Self-hosted or proxied edge: pin your keys and require signatures
FLAGS = NanoFlags::Client.new(
  sdk_key,
  base_url: "https://flags.internal.example",
  verify: { public_keys: [{ "kty" => "OKP", "crv" => "Ed25519", "x" => "…", "kid" => "k1" }], require: true }
)
  • الحزمة التي لا تجتاز التحقق لا تُستخدم: تبقى السابقة، ويتلقى on_error الرمز :signature.
  • الحزمة التي تذكر معرّف مفتاح مجهولًا (تدوير المفاتيح) تحمّل GET /v1/keys مرة واحدة، وعلى الأكثر مرة في الدقيقة. ومع حافة مستضافة ذاتيًا يستخدم verify: true (أو fetch_keys: true) المسار /v1/keys لتلك الحافة؛ ويعطّل verify: false التحقق.
  • تُرفض الحزم الموقّعة لبيئة غير أول بيئة قُبلت.
  • تُرفض الحزم المكتوبة لمحرك تقييم أحدث من NanoFlags::Engine::VERSION (بالرمز :engine) ويبقى الإعداد الحالي قيد الاستخدام: حدّث الجوهرة. والسلسلة المعيارية موصوفة في التواقيع.

القياس والإخفاء

تُرسل عيّنة 10 % من التقييمات كل 10 ثوانٍ، مع بلاغ خدمة كل 60 ثانية. وافتراضيًا لا تغادر قيم السياق العملية أبدًا: لا يُرسل إلا أسماء الخصائص التي تستخدمها قواعد العلم (وأنواع قيمها)، مثل {"plan" => "string"}.

ruby
FLAGS = NanoFlags::Client.new(
  sdk_key,
  events: { sample_rate: 0.05, redact: ->(ctx) { { plan: ctx[:plan] } } }   # what leaves the process
)

QUIET = NanoFlags::Client.new(sdk_key, events: false)   # no telemetry at all

تتلقى redact نسخة من السياق الذي مرّرته وتعيد قيمة Hash التي تُرسل بدل الافتراضي. ويرسل flush الأحداث المنتظرة فورًا.

مزوّد OpenFeature

Gemfile
gem "nanoflags-openfeature"
ruby
require "nanoflags/openfeature"

nanoflags = NanoFlags::Client.new(ENV.fetch("NANOFLAGS_SDK_KEY"), service: "checkout-api")
OpenFeature::SDK.configure do |config|
  config.set_provider_and_wait(NanoFlags::OpenFeature::Provider.new(nanoflags, ready_timeout: 10))
end

client = OpenFeature::SDK.build_client
ctx = OpenFeature::SDK::EvaluationContext.new(targeting_key: current_user.id.to_s, plan: current_user.plan)
client.fetch_boolean_value(flag_key: "new-checkout", default_value: false, evaluation_context: ctx)
client.fetch_string_details(flag_key: "accent", default_value: "blue", evaluation_context: ctx)
  • لـ openfeature-sdk 0.4 أو أحدث (والإصدار 0.6 وما بعده يتطلب Ruby 3.4). تنتظر init مدة ready_timeout ثانية على الأكثر لأول إعداد، وتفشل (حالة خطأ للمزوّد) إن تعذّر تحميل أي إعداد؛ ويواصل العميل المحاولة في الخلفية. ويغلق close_client: true عميل NanoFlags عند shutdown.
  • يصبح مفتاح الاستهداف هو key في NanoFlags (ويتقدّم على خاصية اسمها key). الأسباب: DISABLED وDEFAULT وTARGETING_MATCH وSPLIT (والمتغيّر هو معرّف القاعدة). والأخطاء: FLAG_NOT_FOUND (أو PROVIDER_NOT_READY ما دام لم يُحمَّل شيء) وTYPE_MISMATCH وGENERAL.
  • جلسات الاختبار: مرّر evaluator: -> { NanoFlags.flags_for(nanoflags) } إلى Provider.new ليقيّم عبر جلسة الطلب (التي يحلّها NanoFlags::SessionMiddleware أو NanoFlags.with_session). وخارج الجلسة يتصرّف تمامًا كالعميل.
  • تحمل بيانات العلم الوصفية revision المقيَّمة (مع openfeature-sdk ‏0.5 فأحدث). ومع إصدارات SDK التي تدعم أحداث المزوّد، تطلق النسخة الجديدة PROVIDER_CONFIGURATION_CHANGED، وتطلق تغيّرات الحالة PROVIDER_READY وPROVIDER_STALE (وPROVIDER_ERROR ما دام لم يُحمَّل شيء).

الخيارات

الخيارالافتراضيالوصف
base_url:https://edge.nanoflags.ioعنوان الحافة.
service:"unknown"الاسم الذي تُبلّغ به هذه العملية.
poll_interval:30الثواني بين عمليات الاستطلاع ما دام لا مقبس حيًّا مفتوحًا. و0 يعطّل الاستطلاع.
streaming:trueتلقّي النسخ الجديدة دون استطلاع (WebSocket الحي، وإلا تدفق الأحداث). وfalse يُبقي الاستطلاع وحده.
live:truefalse يتخطى WebSocket الحي ويستخدم تدفق الأحداث والاستطلاع.
live_poll_interval:300الثواني بين استطلاعات الأمان ما دام المقبس الحي سليمًا.
live_url:مشتق من base_urlعنوان WebSocket لـ /v1/live عندما لا يكون base_url مع ws(s):// (متقدّم).
cache_path: · store: · bootstrap:لا شيءانظر آخر إعداد سليم.
verify:مفعّل للحافة المستضافةtrue أو false أو { public_keys:, require:, fetch_keys: }.
events:عيّنة 10 %false أو { sample_rate:, flush_interval:, report_interval:, redact: }.
on_change: · on_error:لا شيءمستمعات تُسجَّل قبل التحميل الأول.
logger:لا شيءكائن Logger (مثل Rails.logger).
start:truefalse يؤجل العمل في الخلفية حتى تستدعي start.
request_timeout: · http:10 · Net::HTTPمهلة HTTP بالثواني، ومحوّل HTTP.

رموز الأخطاء

تصل الأخطاء إلى on_error كـ NanoFlags::Error له code (وhttp_status عند الحاجة): :network و:unauthorized و:http و:invalid_bundle و:store و:config و:signature و:engine و:session و:environment_deleted. ولا يغيّر تحديثٌ فاشل الإعدادَ المستخدم أبدًا، ولا يُرفع أي شيء من استدعاء قراءة.

الإغلاق والإيقاف

  • يوقف close خيوط الخلفية بعد محاولة أخيرة لإرسال القياس (ثانيتان على الأكثر). واستدعاؤه أكثر من مرة آمن. وخطاف at_exit يغلق كل العملاء نيابةً عنك.
  • بعد close تواصل القراءات العمل على آخر إعداد، لكنه يتوقف عن التحديث فقط. ويعيد refresh التحقق فورًا ويعيد هل هناك إعداد قيد الاستخدام.

حل المشكلات

  1. كل قراءة تعيد القيمة الافتراضية. افحص status وlast_error. يعني :unauthorized أن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل.
  2. العمّال لا يرون النسخ الجديدة أبدًا. تأكد من أن العميل في كل عامل قد بدأ: استدعِ NanoFlags::Client.after_fork من خطاف إقلاع العامل في الخادم، أو قيّم مرة واحدة (فأول استدعاء يعيد تشغيل الخيوط بعد التفرّع). والعميل المنشأ بـ start: false يحتاج إلى استدعاء start صراحةً.
  3. خلف وسيط أو مع سلطة شهادات مخصّصة. يحترم HTTP وWebSocket المتغيرات HTTPS_PROXY / NO_PROXY (عبر نفق CONNECT) وSSL_CERT_FILE. وإن حُجبت ترقيات WebSocket تُظهر transport القيمة :stream، وإن حُجب تدفق الأحداث أيضًا فـ :poll.
  4. أخطاء بالرمز :signature. لم تجتز الحزمة التحقق فلم تُستخدم. وإن مرّرت base_url مخصّصًا فثبّت مفاتيح تلك الحافة عبر verify:.
  5. أخطاء بالرمز :environment_deleted. أغلقت الحافة المقبس بالرمز 4004. يتوقف العميل عن إعادة الاتصال ويُبقي آخر إعداد بحالة "stale"؛ استبدل المفتاح.
لغات أخرى
تتوفر حزم SDK أصلية للخوادم أيضًا لـ Python وGo وJava و.NET وPHP. ويمكن للغات الأخرى قراءة أعلام NanoFlags عبر مزوّد OpenFeature OFREP.