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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info

الإصدار 2.0.1

يمكنك كتابة الإدخالات في سجلّات Cloud Logging.

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

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

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

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

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

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

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

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

• إذا كنت عميلاً في Apigee Edge للسحابة الإلكترونية الخاصة، استخدِم واجهة برمجة التطبيقات تعديل خصائص المؤسسة لضبط العلامة features.allowExtensionsInPostClientFlow على true.

لمحة عن Cloud Logging

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

تكتب إضافة Cloud Logging الإدخالات في السجلّ. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات 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 إذا تمّت كتابة الرسالة في السجلّ. وإلا، سيعرض الطلب خطأً. يُرجى الاطّلاع أيضًا على مقالة تصحيح أخطاء إضافة.

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

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

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

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

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

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