Apigee-তে API ট্র্যাফিক ডেটা আপলোড করা হচ্ছে - বিটা রিলিজ৷

প্রাইভেট ক্লাউড v4.18.05 এর জন্য এজ

প্রাইভেট ক্লাউড গ্রাহকদের জন্য সমস্ত প্রান্তকে API প্রক্সি ট্র্যাফিক সম্পর্কে Apigee পরিসংখ্যান জমা দিতে হবে। Apigee সুপারিশ করে যে গ্রাহকরা দিনে একবার সেই তথ্য আপলোড করুন, সম্ভবত একটি ক্রোন কাজ তৈরি করে।

আপনাকে অবশ্যই আপনার প্রোডাকশন API ডিপ্লোয়মেন্টের জন্য ডেটা জমা দিতে হবে, কিন্তু ডেভেলপমেন্ট বা টেস্টিং ডিপ্লয়মেন্টে APIগুলির জন্য নয়। বেশিরভাগ এজ ইনস্টলেশনে, আপনি আপনার উত্পাদন API-এর জন্য নির্দিষ্ট সংস্থা বা পরিবেশ নির্ধারণ করবেন। আপনি যে ডেটা জমা দেন তা শুধুমাত্র সেই উৎপাদন সংস্থা এবং পরিবেশের জন্য।

এই ডেটা আপলোড করতে সহায়তা করার জন্য, Apigee apigee-analytics-colector কমান্ড-লাইন ইউটিলিটির বিটা রিলিজ প্রদান করে। এই ইউটিলিটি API কল ভলিউম রিপোর্ট Apigee এ ফেরত পাঠায়। প্রাইভেট ক্লাউড ইনস্টলেশনের জন্য প্রতিটি এজ এই ইউটিলিটিটি ব্যবহার করতে পারে এবং Apigee-তে ট্রাফিক ডেটা পুনরুদ্ধার করতে পারে।

প্রয়োজনীয়: ডেটা আপলোড করার আগে Apigee সহায়তার সাথে যোগাযোগ করুন

আপনি Apigee-এ ডেটা আপলোড করার আগে, অনবোর্ডিং প্রক্রিয়া সম্পূর্ণ করতে আপনাকে অবশ্যই Apigee Edge সহায়তার সাথে যোগাযোগ করতে হবে।

অ্যাপিজি-বিশ্লেষণ-সংগ্রাহক ইনস্টল করা হচ্ছে

apigee-analytics-collector ইউটিলিটি হল একটি RPM যা আপনি apigee-সার্ভিস ইউটিলিটি ব্যবহার করে ইনস্টল করেন।

কোথায় ইন্সটল করতে হবে

যে নোডটিতে আপনি apigee-analytics-collector ইউটিলিটি ইনস্টল করেন সেটি যেকোন নোড হতে পারে যেটি এজ ম্যানেজমেন্ট সার্ভারে এজ ম্যানেজমেন্ট API অ্যাক্সেস করতে পারে। আপনি এটি সরাসরি ম্যানেজমেন্ট সার্ভারে, এজ ইনস্টলেশনের অন্য নোডে বা একটি পৃথক নোডে ইনস্টল করতে পারেন যতক্ষণ না সেই নোডটি ম্যানেজমেন্ট সার্ভারে API অনুরোধ করতে পারে।

ইন্টারনেট অ্যাক্সেসের প্রয়োজনীয়তা

বাহ্যিক ইন্টারনেট অ্যাক্সেস সহ একটি মেশিনে এপিজি-বিশ্লেষণ-সংগ্রাহক ইউটিলিটি ইনস্টল করুন। তারপর এপিজি-বিশ্লেষণ-সংগ্রাহক ইউটিলিটি সরাসরি অ্যাপিজিতে ডেটা আপলোড করতে পারে।

যদি এজ ম্যানেজমেন্ট সার্ভারে এজ ম্যানেজমেন্ট এপিআই এবং বাহ্যিক ইন্টারনেট অ্যাক্সেসের সাথে উভয় অ্যাক্সেসের সাথে কোন নোড না থাকে, তাহলে আপনি স্থানীয়ভাবে ট্রাফিক ডেটা সংরক্ষণ করতে এজ ম্যানেজমেন্ট এপিআই ব্যবহার করতে পারেন। Apigee-এ আপলোড করার জন্য আপনাকে অবশ্যই ইন্টারনেট অ্যাক্সেস সহ একটি মেশিনে ডেটা স্থানান্তর করতে হবে। এই পরিস্থিতিতে, আপনাকে apigee-analytics-colector ইউটিলিটি ব্যবহার করতে হবে না। আরও জানতে নীচে Apigee-এ ম্যানুয়ালি ডেটা আপলোড করা দেখুন।

ইনস্টলেশন

apigee-analytics-collector ইউটিলিটি ইনস্টল করতে নিম্নলিখিত কমান্ডটি ব্যবহার করুন। যেহেতু আপনি একটি RPM ফাইল ইনস্টল করছেন, এই কমান্ডটি অবশ্যই রুট ব্যবহারকারী বা সম্পূর্ণ sudo অ্যাক্সেস আছে এমন ব্যবহারকারী দ্বারা চালিত হবে। সম্পূর্ণ সুডো অ্যাক্সেসের জন্য, এর অর্থ হল ব্যবহারকারীর রুট হিসাবে একই ক্রিয়াকলাপ সম্পাদন করতে sudo অ্যাক্সেস রয়েছে।

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

এপিজি-বিশ্লেষণ-সংগ্রাহক চলছে

এপিজি-বিশ্লেষণ-সংগ্রাহক ইউটিলিটি কীভাবে চালাতে হয় তা এই বিভাগে বর্ণনা করে।

অ্যাপিজি-বিশ্লেষণ-সংগ্রাহক চালানোর জন্য একজন ব্যবহারকারীকে কনফিগার করা হচ্ছে

আপনাকে অবশ্যই একটি নন-রুট ব্যবহারকারী হিসাবে apigee-analytics-colector চালাতে হবে। এই ব্যবহারকারীর অবশ্যই "apigee" ব্যবহারকারীর সম্পূর্ণ sudo অ্যাক্সেস থাকতে হবে।

একটি ব্যবহারকারীকে "apigee" ব্যবহারকারীর সম্পূর্ণ sudo অ্যাক্সেস পেতে কনফিগার করতে, যোগ করতে sudoers ফাইল সম্পাদনা করতে "visudo" কমান্ড ব্যবহার করুন:

analyticsUser        ALL=(apigee)      NOPASSWD: ALL

যেখানে analyticsUser হল apigee-analytics-colector ইউটিলিটি চালনাকারী ব্যক্তির ব্যবহারকারীর নাম।

apigee-analytics-collector ইউটিলিটি ইনস্টল করার পরে এবং ব্যবহারকারীকে কনফিগার করার পরে, আপনি apigee-analytics-সংগ্রাহক ইউটিলিটির জন্য সহায়তা কমান্ড চালিয়ে ইউটিলিটি পরীক্ষা করতে পারেন:

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

এপিজি-বিশ্লেষণ-সংগ্রাহক চালানোর জন্য প্রয়োজনীয় তথ্য

apigee-analytics-collector কমান্ড চালানোর জন্য এবং Apigee-এ ডেটা ফরওয়ার্ড করতে আপনার নিম্নলিখিত তথ্যের প্রয়োজন:

• apigee_mgmt_api_uri : আপনার ম্যানেজমেন্ট সার্ভারে এজ এপিআই-এর বেস ইউআরএল। এই URLটি সাধারণত ফর্মে থাকে:
  http:// ms_IP :8080/v1
  
  যেখানে ms_IP হল IP ঠিকানা বা আপনার ব্যবস্থাপনা সার্ভার এবং 8080 হল Edge API দ্বারা ব্যবহৃত পোর্ট। আপনি যদি এজ এপিআই-এর জন্য একটি DNS এন্ট্রি তৈরি করেন, তাহলে ইউআরএলটি ফর্মে রয়েছে:
  http:// ms_DNS /v1
  
  আপনি যদি এজ ম্যানেজমেন্ট এপিআই-তে TLS সক্ষম করেন, তাহলে এটি ফর্মে রয়েছে:
  https ://ms_IP:8080/v1
  https ://ms_DNS/v1
• apigee_mgmt_api_email : এজ /স্ট্যাটস এপিআই-এ অ্যাক্সেস সহ একটি অ্যাকাউন্টের ইমেল ঠিকানা। প্রায়শই এটি হবে এজ সিস্টেম অ্যাডমিনিস্ট্রেটরের ইমেল, অথবা আপনার প্রোডাকশন সংস্থাগুলির জন্য সংস্থা প্রশাসকের ইমেল।
• apigee_mgmt_api_password : apigee_mgmt_api_email দ্বারা নির্দিষ্ট করা অ্যাকাউন্টের জন্য এজ পাসওয়ার্ড।
• apigee_analytics_client_id এবং apigee_analytics_secret : Apigee-এ ডেটা আপলোড করার জন্য আপনার প্রমাণপত্র। apigee_analytics_client_id এবং apigee_analytics_secret পেতে অনুগ্রহ করে Apigee সহায়তার সাথে একটি টিকিট জমা দিন।

উদাহরণ কমান্ড

এজ ইনস্টলেশনে সমস্ত সংস্থা এবং পরিবেশের জন্য ট্র্যাফিক ডেটা পুনরুদ্ধার করার এবং Apigee-এ সেই ডেটা আপলোড করার জন্য নীচে একটি উদাহরণ কমান্ড দেখানো হয়েছে। apigee-analytics-collector কমান্ড চালানোর জন্য আপনি কিভাবে apigee-service ব্যবহার করেন তা লক্ষ্য করুন:

>  /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 <কমা-বিভক্ত আইটেমগুলির তালিকা>
• -x, --exclude_orgs <কমা দিয়ে আলাদা করা আইটেমের তালিকা>
• -n, --include_envs <কমা দ্বারা পৃথক করা আইটেমগুলির তালিকা>
• -e, --exclude_envs <কমা দ্বারা পৃথক করা আইটেমগুলির তালিকা>

উদাহরণস্বরূপ, শুধুমাত্র উৎপাদন সংস্থা এবং পরিবেশ নির্দিষ্ট করতে, -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-এ ডেটা আপলোড বাদ দেয়। তারপরে আপনি Apigee-এ ডেটা পাঠাতে -S বিকল্প ছাড়াই কমান্ডটি পুনরায় চালাতে পারেন।

-S বিকল্পটি ব্যবহার করার একটি কারণ হল আপনি স্থানীয়ভাবে বিভিন্ন ধরণের ডেটা প্রদর্শন করতে পারেন। Apigee শুধুমাত্র প্রয়োজন যে আপনি API ট্র্যাফিক ডেটা আপলোড করুন, কিন্তু -D বিকল্প আপনাকে API পণ্য, বিকাশকারী, অ্যাপ্লিকেশন, বা API প্রক্সি সম্পর্কে ডেটা প্রদর্শন করতে দেয়। নীচের উদাহরণটি স্থানীয়ভাবে বিকাশকারী ডেটা প্রদর্শন করতে -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 বিকল্পটি অন্তর্ভুক্ত করুন এবং apigee-analytics-colector দ্বারা তৈরি কার্ল কমান্ডগুলি দেখতে -R বিকল্পটি অন্তর্ভুক্ত করুন:

 >  /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-colector ইউটিলিটির বিকল্পগুলির সম্পূর্ণ সেট তালিকাভুক্ত করে:

Apigee-তে ম্যানুয়ালি ডেটা আপলোড করা হচ্ছে

Apigee সুপারিশ করে যে আপনি বাহ্যিক ইন্টারনেট অ্যাক্সেস সহ একটি মেশিনে apigee-analytics-collector ইউটিলিটি ইনস্টল করুন। তারপর এপিজি-বিশ্লেষণ-সংগ্রাহক ইউটিলিটি সরাসরি অ্যাপিজিতে ডেটা আপলোড করতে পারে।

যাইহোক, যদি মেশিনের বাহ্যিক ইন্টারনেট অ্যাক্সেস না থাকে, তাহলে ট্র্যাফিক ডেটা সংগ্রহ করতে এজ ম্যানেজমেন্ট API ব্যবহার করুন এবং তারপরে ইন্টারনেট অ্যাক্সেস সহ একটি মেশিন থেকে অ্যাপিজিতে আপলোড করতে cURL কমান্ড ব্যবহার করুন। আপনার এজ ইনস্টলেশনের প্রতিটি উত্পাদন সংস্থা এবং পরিবেশের জন্য আপনাকে এই প্রক্রিয়াটি পুনরাবৃত্তি করতে হবে।

একটি নির্দিষ্ট সময়ের ব্যবধানের জন্য একটি নির্দিষ্ট সংস্থা এবং পরিবেশের জন্য ট্রাফিক ডেটা সংগ্রহ করতে নিম্নলিখিত 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"

এই কমান্ডটি এজ গেট API বার্তা গণনা API ব্যবহার করে। এই আদেশে:

• apigee_mgmt_api_email:apigee_mgmt_api_password এজ /স্ট্যাটস এপিআই-এ অ্যাক্সেস সহ একটি অ্যাকাউন্টের ইমেল ঠিকানা নির্দিষ্ট করে।
• <ms_IP> হল এজ ম্যানেজমেন্ট সার্ভারের IP ঠিকানা বা DNS নাম।
• {org_name} এবং {env_name} org এবং পরিবেশ নির্দিষ্ট করে।
• apiproxy হল মাত্রা যা API প্রক্সি দ্বারা মেট্রিক্সকে গোষ্ঠীভুক্ত করে।
• MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour সংগ্রহ করার জন্য মেট্রিক্সের সময়ের এককে বিভক্ত সময়সীমা নির্দিষ্ট করে। লক্ষ্য করুন যে cURL কমান্ডটি টাইম রেঞ্জের স্পেসগুলির জন্য হেক্স কোড %20 ব্যবহার করে।

উদাহরণস্বরূপ, API প্রক্সি বার্তা সংগ্রহ করতে 24 ঘন্টা সময়ের মধ্যে ঘন্টার পর ঘন্টা গণনা করতে, নিম্নলিখিত পরিচালনা API কলটি ব্যবহার করুন। টাইমরেঞ্জে ইউআরএল-এনকোড করা অক্ষর রয়েছে।

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"

আপনি ফর্মে একটি প্রতিক্রিয়া দেখতে হবে:

{
  "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" ]
  }
}

তারপরে ইন্টারনেট অ্যাক্সেস সহ একটি মেশিন থেকে অ্যাপিজিতে সেই ডেটা আপলোড করতে, নিম্নলিখিত 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 সমর্থন থেকে পেয়েছেন।
• {org_name} org নির্দিষ্ট করে।
• {"এনভায়রনমেন্টস"...}- এ cURL কমান্ডের ফলাফল রয়েছে যা আপনি উপরে পরিসংখ্যান সংগ্রহ করতে ব্যবহার করেছেন।