Apigee-তে API ট্রাফিক ডেটা আপলোড করা - বিটা রিলিজ

Edge for Private Cloud v4.18.01

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

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

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

apigee-analytics-collector-এর আপলোড করা ডেটা অ্যাক্সেস করা হচ্ছে

apigee-analytics-collector ইউটিলিটির মাধ্যমে ডেটা আপলোড করার পরে, আপনি এটি Apigee 360-এ দেখতে পারবেন।

ডেটা দেখতে, Apigee 360-তে লগ-ইন করুন এবং তারপরে ব্যবহার বিকল্প বেছে নিন। ব্যবহার পৃষ্ঠায় আপনার প্রতিটি Edge সংস্থার জন্য ব্যবহারের গ্রাফ ও ব্যবহারের ডেটার সারণী দেখানো হয়।

apigee-analytics-collector ইনস্টল করা হচ্ছে

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

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

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

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

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

Edge ম্যানেজমেন্ট সার্ভারে Edge ম্যানেজমেন্ট API-তে অ্যাক্সেস এবং এক্সটার্নাল ইন্টারনেট অ্যাক্সেস, দুটিই আছে এমন কোনও নোড না থাকলে, আপনি ট্রাফিক ডেটা লোকালি সেভ করার জন্য Edge ম্যানেজমেন্ট API ব্যবহার করতে পারেন। তারপর, 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-collector চলছে

apigee-analytics-collector ইউটিলিটি কীভাবে রান করতে হয় তা এই বিভাগে বর্ণনা করা হয়েছে।

apigee-analytics-collector চালানোর জন্য ব্যবহারকারীকে কনফিগার করা হচ্ছে

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

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

analyticsUser        ALL=(apigee)      NOPASSWD: ALL

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

apigee-analytics-collector ইউটিলিটি ইনস্টল এবং ব্যবহারকারীকে কনফিগার করার পরে, আপনি 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: আপনার ম্যানেজমেন্ট সার্ভারে Edge API-এর বেস URL। এই URL সাধারণত এই ফর্ম্যাটে থাকে:
  http://ms_IP:8080/v1
  
  যেখানে ms_IP হল IP অ্যাড্রেস বা আপনার ম্যানেজমেন্ট সার্ভার এবং 8080 হল Edge API-এর ব্যবহার করা পোর্ট। আপনি যদি Edge API-এর জন্য DNS এন্ট্রি তৈরি করে থাকেন, তাহলে URL-এর ফর্ম্যাট হবে:
  http://ms_DNS/v1
  
  আপনি যদি Edge ম্যানেজমেন্ট API-তে TLS চালু করেন, তাহলে ফর্ম্যাট হবে:
  https://ms_IP:8080/v1
  https://ms_DNS/v1
• apigee_mgmt_api_email: Edge /stats API-তে অ্যাক্সেস আছে এমন অ্যাকাউন্টের ইমেল আইডি। সাধারণত, এটি Edge সিস্টেম অ্যাডমিনিস্ট্রেটরের ইমেল বা আপনার প্রোডাকশন সংস্থার জন্য সংস্থার অ্যাডমিনিস্ট্রেটরের ইমেল হবে।
• apigee_mgmt_api_password: apigee_mgmt_api_email-এর মাধ্যমে নির্দিষ্ট করা অ্যাকাউন্টের জন্য Edge পাসওয়ার্ড।
• apigee_analytics_client_id এবং apigee_analytics_secret: Apigee-তে ডেটা আপলোড করার জন্য আপনার ক্রেডেনশিয়াল। apigee_analytics_client_id এবং apigee_analytics_secret পেতে Apigee সহায়তা টিমের কাছে টিকিট জমা দিন।

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

Edge ইনস্টলেশনে সব সংস্থা ও এনভায়রনমেন্টের জন্য ট্রাফিক ডেটা ফিরিয়ে আনা এবং 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 <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-তে ডেটা আপলোড করা বাদ দেয়। তারপর আপনি 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-collector-এর মাধ্যমে তৈরি করা কার্ল কমান্ড দেখতে -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-collector ইউটিলিটির সম্পূর্ণ বিকল্পের সেট তালিকাভুক্ত করা হয়েছে:

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

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

তবে, মেশিনে এক্সটার্নাল ইন্টারনেট অ্যাক্সেস না থাকলে, ট্রাফিক ডেটা সংগ্রহ করতে Edge ম্যানেজমেন্ট API ব্যবহার করুন এবং তারপরে ইন্টারনেট অ্যাক্সেস সহ মেশিন থেকে Apigee-তে এটি আপলোড করতে cURL কমান্ড ব্যবহার করুন। আপনার 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 মেসেজ কাউন্ট API ব্যবহার করে। এই কমান্ডে:

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

যেমন, ২৪ ঘণ্টার মধ্যে প্রতি ঘণ্টায় API প্রক্সি মেসেজের সংখ্যা সংগ্রহ করতে, নিম্নলিখিত ম্যানেজমেন্ট API কল ব্যবহার করুন। timeRange-এ URL-এনকোড করা অক্ষর আছে।

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"

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

{
  "environments" : [ {
    "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"
  } ],
  "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 specify Apigee-তে ডেটা আপলোড করার জন্য আপনার ক্রেডেনশিয়াল যা আপনি Apigee সহায়তা থেকে পেয়েছেন।
• {org_name} সংস্থার নাম উল্লেখ করে।
• {"environments"...}-এ cURL কমান্ডের ফলাফল থাকে যা আপনি উপরে পরিসংখ্যান সংগ্রহ করতে ব্যবহার করেছেন।