تحميل بيانات عدد زيارات واجهة برمجة التطبيقات إلى Apigee - الإصدار التجريبي

على جميع عملاء Edge for Private Cloud إرسال إحصاءات واجهة برمجة التطبيقات إلى Apigee. زيارات الخادم الوكيل. تنصح Apigee بأن يحمّل العملاء تلك المعلومات مرة واحدة في اليوم، وربما عن طريق تقوم بإنشاء وظيفة cron.

يجب إرسال البيانات الخاصة بعمليات نشر واجهة برمجة التطبيقات للإنتاج، ولكن ليس لواجهات برمجة التطبيقات قيد التطوير. أو اختبار عمليات النشر في معظم عمليات تثبيت Edge، ستُحدِّد مؤسسات أو بيئات لواجهات برمجة تطبيقات الإنتاج. البيانات التي ترسلها مخصّصة لشركات الإنتاج فقط. المؤسسات والبيئات.

للمساعدة في تحميل هذه البيانات، توفّر Apigee الإصدار التجريبي من سطر الأوامر apigee-analytics-collector الأخرى. ترسل هذه الأداة تقرير حجم طلبات البيانات من واجهة برمجة التطبيقات إلى Apigee. كل حواف يمكن لتثبيت Private Cloud استخدام هذه الأداة لاسترداد بيانات حركة المرور والإبلاغ عنها إلى Apigee.

الإجراء المطلوب: يُرجى التواصل مع فريق دعم Apigee قبل تحميل البيانات

قبل أن تتمكّن من تحميل البيانات إلى Apigee، عليك التواصل مع Apigee Edge Support لإكمال عملية الإعداد. الدفع.

تثبيت أداة جمع الإحصاءات من واجهة برمجة التطبيقات apigee

apigee-analytics-collector هي قيمة RPM تقوم بتثبيتها باستخدام الأداة المساعدة apigee-service.

مكان التثبيت

يمكن أن تكون العقدة التي يتم تثبيت الأداة apigee-analytics-collector عليها أي عقدة يمكنها الوصول إلى واجهة برمجة تطبيقات إدارة Edge على خادم إدارة Edge. يمكنك تثبيته مباشرة على خادم الإدارة، أو على عقدة أخرى من تثبيت Edge، أو على قاعدة بيانات طالما أن هذه العقدة يمكنها تقديم طلبات واجهة برمجة التطبيقات إلى خادم الإدارة.

الوصول إلى الإنترنت المتطلبات

تثبيت أداة apigee-analytics-collector على الجهاز مع اتصال خارجي بالإنترنت. ثم تستخدم الأداة apigee-analytics-collector تحميل البيانات مباشرةً إلى Apigee.

في حال لم يكن هناك عقدة تتيح الوصول إلى واجهة برمجة تطبيقات إدارة Edge على خادم إدارة Edge والاتصال بالإنترنت الخارجي، فيمكنك استخدام واجهة برمجة تطبيقات إدارة Edge لحفظ حركة البيانات البيانات محليًا. يجب بعد ذلك نقل البيانات إلى جهاز متصل بالإنترنت لتحميلها إليه Apigee. في هذا السيناريو، لن تحتاج إلى استخدام apigee-analytics-collector الأخرى. عرض يتم تحميل البيانات يدويًا إلى Apigee لمزيد من المعلومات.

تثبيت

استخدم الأمر التالي لتثبيت الأداة apigee-analytics-collector. لأنّ تثبيت ملف RPM، فيجب تشغيل هذا الأمر عن طريق المستخدم الجذر أو المستخدم الذي الإذن بالوصول الكامل إلى برنامج sudo. للحصول على إمكانية الوصول الكامل إلى برنامج sudo، هذا يعني أنّ المستخدم لديه إذن الوصول إلى برنامج sudo لتنفيذ الإجراء نفسه العمليات كجذر.

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector install

تشغيل apigee-analytics-collect

يصف هذا القسم كيفية تشغيل أداة apigee-analytics-collector.

ضبط مستخدِم لتشغيل أداة جمع الإحصاءات من واجهة برمجة التطبيقات apigee

يجب تشغيل apigee-analytics-collector كجذر غير جذر. المستخدم. يجب أن يكون لدى هذا المستخدم إذن وصول كامل إلى "واجهة برمجة التطبيقات" (apigee) المستخدم.

لتكوين مستخدم لديه إمكانية الدخول الكامل إلى sudo إلى "apigee". استخدم "visudo" أمر موجَّه إلى تعديل ملف sudoers لإضافة ما يلي:

analyticsUser        ALL=(apigee)      NOPASSWD: ALL

حيث يكون analyticsUser هو اسم المستخدم للشخص الذي يسعى إلى تحقيق نتيجة الأداة المساعدة apigee-analytics-collector.

بعد تثبيت أداة apigee-analytics-collector وتكوين المستخدم، يمكنك اختبار الأداة من خلال تشغيل أمر help أداة apigee-analytics-collector:

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic --help

المعلومات المطلوبة لتشغيل apigee-analytics-collector

يجب الحصول على المعلومات التالية لتشغيل الأمر apigee-analytics-collector ولإعادة توجيه البيانات إلى Apigee:

• apigee_mgmt_api_uri: عنوان URL الأساسي لواجهة برمجة تطبيقات Edge في الإدارة الخادم. عادةً ما يكون عنوان URL بالتنسيق التالي:

  http://ms_IP:8080/v1

  حيث ms_IP هو عنوان IP أو خادم الإدارة و8080 المنفذ الذي تستخدمه واجهة برمجة تطبيقات Edge. إذا أنشأت إدخال نظام أسماء نطاقات لواجهة برمجة تطبيقات Edge، فسيكون عنوان URL في النموذج:

  http://ms_DNS/v1

  إذا قمت بتمكين بروتوكول أمان طبقة النقل (TLS) على واجهة برمجة تطبيقات إدارة Edge، فحينئذٍ يكون على النحو التالي:

  https://ms_IP:8080/v1
  https://ms_DNS/v1

• apigee_mgmt_api_email: عنوان البريد الإلكتروني لحساب يمكنه الوصول إلى واجهات برمجة تطبيقات Edge /stats غالبًا ما تتضمن هذه سيكون البريد الإلكتروني لمشرف نظام Edge أو البريد الإلكتروني لمشرف المؤسسة لمؤسسات الإنتاج
• apigee_mgmt_api_password: كلمة مرور Edge للحساب الذي تحدده apigee_mgmt_api_email
• apigee_analytics_client_id وapigee_analytics_secret: بيانات الاعتماد الخاصة بك لتحميل البيانات إلى Apigee يُرجى إرسال تذكرة إلى Apigee Edge Support للحصول على apigee_analytics_client_id وapigee_analytics_secret

أمثلة على الطلبات

في ما يلي مثال على أمر لاسترداد بيانات حركة المرور لجميع المؤسسات البيئات في تثبيت Edge وتحميل تلك البيانات إلى Apigee. هل لاحظت كيف استخدام apigee-service من أجل شغِّل الأمر apigee-analytics-collector:

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic \
--apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \
--apigee_mgmt_api_email $ae_username \
--apigee_mgmt_api_password $ae_password \
--apigee_analytics_client_id $apigee_analytics_client_id \
--apigee_analytics_secret $apigee_analytics_secret

لاحظ أن الأمر يحتوي على جميع المعلومات المطلوبة، مثل apigee_analytics_client_id وapigee_analytics_secret.

من المفترض أن تظهر لك النتائج في النموذج:

[
  {
    "org": "myOrg",
    "env": "prod",
    "time_range_start": "08/27/2016 00:00",
    "time_range_end": "08/30/2016 00:00",
    "response": [
      {
        "store_org_env_metrics_hourly_v4": 1
      }
    ]
  },
  {
    "org": "VALIDATE",
    "env": "test",
    "time_range_start": "08/27/2016 00:00",
    "time_range_end": "08/30/2016 00:00",
    "response": [
      {
        "store_org_env_metrics_hourly_v4": 1
      }
    ]
  }
]

استخدام خيارات سطر الأوامر للأمر للتحكم في إجراءاته. استخدِم الخيارات التالية لتنفيذ ما يلي: تحديد المؤسسات والبيئات المراد تضمينها في البيانات التي تم إنشاؤها:

• -i, --include_orgs comma-separated list of items
• -x, --exclude_orgs comma-separated list of items
• -n, --include_envs comma-separated list of items
• -e, --exclude_envs comma-separated list of items

على سبيل المثال، لتحديد مؤسسات وبيئات الإنتاج فقط، استخدم -i (أو --include_orgs) و-n (أو خيارات --include_envs):

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod \
--apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \
--apigee_mgmt_api_email $ae_username \
--apigee_mgmt_api_password $ae_password \
--apigee_analytics_client_id $apigee_analytics_client_id \
--apigee_analytics_secret $apigee_analytics_secret

في هذا المثال، يمكنك جمع البيانات فقط من بيئة إنتاج myOrg

لتفريغ البيانات إلى شاشة لفحصها قبل إرسالها إلى Apigee، استخدِم -S الخيار:

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S \
  --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \
  --apigee_mgmt_api_email $ae_username \
  --apigee_mgmt_api_password $ae_password \
  --apigee_analytics_client_id $apigee_analytics_client_id \
  --apigee_analytics_secret $apigee_analytics_secret

يؤدي الخيار -S إلى حذف البيانات. حمِّلها على Apigee. يمكنك بعد ذلك إعادة تشغيل الأمر بدون خيار -S لإرسال البيانات إلى Apigee.

أحد أسباب استخدام "-S" حتى تتمكن من عرض أنواع مختلفة من البيانات محليًا. تتطلّب Apigee منك فقط تحميل بيانات عدد زيارات واجهة برمجة التطبيقات، ولكن يتيح لك الخيار -D عرض بيانات عن واجهة برمجة التطبيقات المنتجات أو المطورين أو التطبيقات أو الخوادم الوكيلة لواجهة برمجة التطبيقات. يستخدم المثال أدناه -D خياران (-S) لعرض بيانات المطوِّرين محليًا:

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S -D devs \
  --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \
  --apigee_mgmt_api_email $ae_username \
  --apigee_mgmt_api_password $ae_password \
  --apigee_analytics_client_id $apigee_analytics_client_id \
  --apigee_analytics_secret $apigee_analytics_secret

أدرِج خيار -v للحصول على النتائج المطوَّلة، وخيار -R لعرض أوامر curl التي تم إنشاؤها بواسطة apigee-analytics-collector:

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S -R -v \
  --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \
  --apigee_mgmt_api_email $ae_username \
  --apigee_mgmt_api_password $ae_password \
  --apigee_analytics_client_id $apigee_analytics_client_id \
  --apigee_analytics_secret $apigee_analytics_secret

يحتوي القسم التالي على قائمة كاملة بخيارات سطر الأوامر.

مَعلمات الأوامر

يسرد الجدول التالي مجموعة كاملة من الخيارات أداة apigee-analytics-collector:

تحميل البيانات يدويًا إلى Apigee

تنصحك Apigee بتثبيت أداة apigee-analytics-collector على جهاز متصل بالإنترنت الخارجي. ثم تستخدم الأداة apigee-analytics-collector تحميل البيانات مباشرةً إلى Apigee.

ومع ذلك، إذا لم يكن للجهاز إمكانية وصول خارجي إلى الإنترنت، فاستخدم واجهة برمجة التطبيقات Edge management API لجمع بيانات حركة المرور، ثم استخدام أوامر curl لتحميلها إلى Apigee من الجهاز المزوّد الوصول إلى الإنترنت. يجب تكرار هذه العملية لكل مؤسسة إنتاج جديدة في تثبيت Edge.

يمكنك استخدام الأمر curl التالي لجمع بيانات حركة البيانات لمؤسسة معيّنة البيئة خلال فترة زمنية محددة:

curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \
"http://ms_IP:8080/v1/organizations/org_name/environments/env_name/stats/apiproxy?select=sum(message_count)&timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour"

يستخدم هذا الأمر واجهة برمجة تطبيقات عدد الرسائل في Edge Get API. وفي هذا الأمر:

• يحدد apigee_mgmt_api_email:apigee_mgmt_api_password عنوان بريد إلكتروني لحساب لديه إمكانية الوصول إلى واجهات برمجة تطبيقات Edge /stats.
• ms_IP هو عنوان IP أو اسم نظام أسماء النطاقات في Edge. خادم الإدارة.
• يحدد كل من org_name وenv_name المؤسسة والبيئة.
• apiproxy هو البعد الذي يجمع المقاييس حسب الخوادم الوكيلة لواجهة برمجة التطبيقات.
• MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour يحدد النطاق الزمني مقسومًا على وحدات زمنية للمقاييس التي يجب جمعها. لاحظ أن يستخدم الأمر curl الرمز السداسي %20 للمسافات في الوقت المحدد. النطاق.

على سبيل المثال، لجمع أعداد رسائل الخادم الوكيل لواجهة برمجة التطبيقات ساعة بساعة على مدار 24 ساعة، يمكنك استخدام السمة تتم متابعة طلب بيانات من واجهة برمجة التطبيقات

curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \
"http://192.168.56.103:8080/v1/organizations/myOrg/environments/prod/stats/apiproxy?select=sum(message_count)&timeRange=01%2F01%2F2018%2000%3A00~01%2F02%2F2018%2000%3A00&timeUnit=hour"

(يُرجى العلم أنّ timeRange يحتوي على أحرف مرمّزة في عنوان URL).

من المفترض أن يظهر لك ردّ في النموذج:

{
  "environments" : [ {
    "dimensions" : [ {
      "metrics" : [ {
        "name" : "sum(message_count)",
        "values": [
                {
                  "timestamp": 1514847600000,
                  "value": "35.0"
                },
                {
                  "timestamp": 1514844000000,
                  "value": "19.0"
                },
                {
                  "timestamp": 1514840400000,
                  "value": "58.0"
                },
                {
                  "timestamp": 1514836800000,
                  "value": "28.0"
                },
                {
                  "timestamp": 1514833200000,
                  "value": "29.0"
                },
                {
                  "timestamp": 1514829600000,
                  "value": "33.0"
                },
                {
                  "timestamp": 1514826000000,
                  "value": "26.0"
                },
                {
                  "timestamp": 1514822400000,
                  "value": "57.0"
                },
                {
                  "timestamp": 1514818800000,
                  "value": "41.0"
                },
                {
                  "timestamp": 1514815200000,
                  "value": "27.0"
                },
                {
                  "timestamp": 1514811600000,
                  "value": "47.0"
                },
                {
                  "timestamp": 1514808000000,
                  "value": "66.0"
                },
                {
                  "timestamp": 1514804400000,
                  "value": "50.0"
                },
                {
                  "timestamp": 1514800800000,
                  "value": "41.0"
                },
                {
                  "timestamp": 1514797200000,
                  "value": "49.0"
                },
                {
                  "timestamp": 1514793600000,
                  "value": "35.0"
                },
                {
                  "timestamp": 1514790000000,
                  "value": "89.0"
                },
                {
                  "timestamp": 1514786400000,
                  "value": "42.0"
                },
                {
                  "timestamp": 1514782800000,
                  "value": "47.0"
                },
                {
                  "timestamp": 1514779200000,
                  "value": "21.0"
                },
                {
                  "timestamp": 1514775600000,
                  "value": "27.0"
                },
                {
                  "timestamp": 1514772000000,
                  "value": "20.0"
                },
                {
                  "timestamp": 1514768400000,
                  "value": "12.0"
                },
                {
                  "timestamp": 1514764800000,
                  "value": "7.0"
                }
              ]
            }
          ],
          "name" : "proxy1"
      } ],
    "name" : "prod"
  } ],
  "metaData" : {
    "errors" : [ ],
    "notices" : [ "query served by:53dab80c-e811-4ba6-a3e7-b96f53433baa", "source pg:6b7bab33-e732-405c-a5dd-4782647ce096", "Table used: myorg.prod.agg_api" ]
  }
}

لتحميل تلك البيانات إلى Apigee من جهاز متصل بالإنترنت، استخدِم الخطوات التالية: الأمر curl:

curl -X POST -H 'Content-Type:application/json' \
  -u apigee_analytics_client_id:apigee_analytics_secret \
  https://nucleus-api-prod.apigee.com/v1/apigee-analytics-cli-api/traffic/orgs/org_name/apis -d '"environments"...'

المكان:

• يحدد apigee_analytics_client_id:apigee_analytics_secret بيانات الاعتماد لتحميل البيانات إلى Apigee التي حصلت عليها من Apigee.
• تحدّد السمة org_name اسم المؤسسة.
• يتضمن "environments"... نتائج الأمر curl الذي التي استخدمتها لجمع الإحصائيات أعلاه.