إضافة التسجيل في السحابة الإلكترونية من Google

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

الإصدار 1.6.1

اكتب إدخالات في سجلات التسجيل في السحابة الإلكترونية.

يوفر هذا المحتوى مرجعًا لضبط هذه الإضافة واستخدامها.

المتطلبات الأساسية

قبل استخدام هذه الإضافة من خادم وكيل لواجهة برمجة التطبيقات، يجب:

1. في "إدارة الهوية وإمكانية الوصول"، يمكنك إسناد دور التسجيل > كاتب السجلّات إلى عضو المشروع الذي سيمثّل إضافتك في نظام التسجيل في السحابة الإلكترونية. للحصول على تعليمات عن كيفية منح الأدوار، يُرجى الاطّلاع على منح الأدوار لحساب خدمة لموارد محدَّدة. لمزيد من المعلومات عن تسجيل الأدوار، يُرجى الاطّلاع على دليل التحكّم في الوصول.

2. استخدام Google Cloud Console لإنشاء مفتاح لحساب الخدمة

3. استخدِم محتوى ملف JSON للمفتاح الناتج عند تثبيت الإضافة وضبطها باستخدام مرجع الإعدادات.

يمكن طلب هذه الإضافة من خلال سياسة ExtensionCallout المتوفّرة في PostClientFlow. إذا كنت تريد استخدام سياسة ExtensionCallout لطلب هذه الإضافة من PostClientFlow، تأكّد من ضبط العلامة features.allowExtensionsInPostClientFlow على true في مؤسستك.

• إذا كنت أحد عملاء Apigee Edge for Public Cloud، يجب التواصل مع فريق دعم Apigee Edge للتأكّد من ضبط العلامة features.allowExtensionsInPostClientFlow على true في مؤسستك.

• إذا كنت أحد عملاء Apigee Edge for Private Cloud، يمكنك استخدام واجهة برمجة التطبيقات تحديث خصائص المؤسسة لضبط العلامة features.allowExtensionsInPostClientFlow على true.

لمحة عن التسجيل في السحابة الإلكترونية

التسجيل في السحابة الإلكترونية هو جزء من مجموعة عمليات Google Cloud. ويتضمن مساحة تخزين للسجلات، وواجهة مستخدم تسمى مستكشف السجلات، وواجهة برمجة تطبيقات لإدارة السجلات آليًا. باستخدام Cloud Logging، يمكنك قراءة إدخالات السجلّ وكتابتها والبحث في السجلات وفلترتها وتصدير السجلات وإنشاء مقاييس مستندة إلى السجلات.

تكتب إضافة Cloud Logging حاليًا الإدخالات في السجلّ. لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على مستندات تسجيل الدخول إلى السحابة الإلكترونية.

عيّنات

توضّح الأمثلة التالية كيفية ضبط الدعم لإجراءات إضافة "التسجيل في السحابة الإلكترونية" باستخدام سياسة ExtensionCallout.

السجلّ العام

تعمل السياسة التالية على كتابة الرسالة This is a test في سجلّ باسم example-log في مورد Cloud Global. في الاستخدام الفعلي، قد يتم تضمين الرسالة في متغير تدفق تم تعيينه في مكان آخر في الخادم الوكيل لواجهة برمجة التطبيقات.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Logging-Extension">
    <DisplayName>Logging Connector</DisplayName>
    <Connector>cloud-extension-sample</Connector>
    <Action>log</Action>
    <Input><![CDATA[{
        "logName": "example-log",
        "metadata": {
            "resource": {
                "type": "global",
                "labels": {
                    "project_id": "my-test"
                }
            }
        },
        "message": "This is a test."
    }]]></Input>
</ConnectorCallout>

يوفر هذا المحتوى مرجعًا لضبط هذه الإضافة واستخدامها. لمعرفة خطوات إعداد إضافة باستخدام وحدة تحكُّم Apigee، يُرجى الاطّلاع على إدراج إضافة وضبطها.

المهام

log

يكتب رسالة في السجل.

يؤدي هذا الإجراء إلى كتابة إدخال في سجلّ Cloud Logging. تتألف إدخالات السجل من بيانات وصفية وبيانات الإدخال. لمزيد من المعلومات عن إدخالات السجل، راجع مرجع الإدخال. للحصول على معلومات عن محتوى السمة metadata، يُرجى الاطّلاع على عنصر LogEntry في مستندات Cloud Logging.

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "cloud-log-name-to-use",
  "metadata" : JSON-structured-metadata,
  "message" : "data-to-log-as-entry"
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message": "This is a test."
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message" : { "info" :  "This is a test." }
}]]></Input>

مَعلمات الطلب

الإجابة

None إذا تمت كتابة الرسالة في السجلّ. وإلا، فسيعرض الطلب خطأ. راجع أيضًا تصحيح أخطاء الإضافة.

مرجع الإعدادات

استخدِم ما يلي عند ضبط هذه الإضافة ونشرها للاستخدام في الخوادم الوكيلة لواجهة برمجة التطبيقات.

خصائص الإضافات الشائعة

السمات التالية متاحة لكل إضافة.

الخصائص لحزمة الإضافات هذه

يمكنك تحديد قيم لخصائص الإعداد التالية الخاصة بهذه الإضافة.