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

ব্যক্তিগত ক্লাউডের জন্য প্রান্ত v. 4.16.09

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

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

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

Apigee-তে ট্রাফিক ডেটা আপলোড করার প্রক্রিয়া সম্পর্কে অতিরিক্ত তথ্যের জন্য, FAQ দেখুন।

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

apigee-analytics-collector ইউটিলিটি হল একটি Node.js মডিউল যা আপনি npm ব্যবহার করে ইনস্টল করেন।

ইনস্টলেশন প্রয়োজনীয়তা

এপিজি-বিশ্লেষণ-সংগ্রাহক ইউটিলিটির প্রয়োজন:

• npm 2.x বা তার পরে
• Node.js 4.x

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

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

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

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

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

ইনস্টলেশন

apigee-analytics-colector ইউটিলিটি ইনস্টল করতে নিম্নলিখিত কমান্ডটি ব্যবহার করুন:

> npm install apigee-analytics-collector -g

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

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

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

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-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 ) বিকল্পগুলি ব্যবহার করুন:

> 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 বিকল্পটি ব্যবহার করুন:

> 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 বিকল্পগুলি ব্যবহার করে:

> 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 বিকল্পটি অন্তর্ভুক্ত করুন:

 > 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/?select=sum(message_count)&timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM"

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

• apigee_mgmt_api_email:apigee_mgmt_api_password এজ /স্ট্যাটস এপিআই-এ অ্যাক্সেস সহ একটি অ্যাকাউন্টের ইমেল ঠিকানা নির্দিষ্ট করে।
• <ms_IP> হল এজ ম্যানেজমেন্ট সার্ভারের IP ঠিকানা বা DNS নাম।
• {org_name} এবং {env_name} org এবং পরিবেশ নির্দিষ্ট করে।
• MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM সংগ্রহ করার জন্য পরিসংখ্যানের সময়সীমা নির্দিষ্ট করে৷ লক্ষ্য করুন যে 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/?select=sum(message_count)&timeRange=08/29/2016%2000:00~08/30/2016%2000:00"

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

{
  "environments" : [ {
    "metrics" : [ {
      "name" : "sum(message_count)",
      "values" : [ "42.0" ]
    } ],
    "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 কমান্ডের ফলাফল রয়েছে যা আপনি উপরে পরিসংখ্যান সংগ্রহ করতে ব্যবহার করেছেন।