درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
وقتی از دستورگان apigee-provision برای ایجاد سازمان جدید استفاده میکنید، گاهی اوقات دستورگان با پیام خطا از سیستم خارج میشود. پساز این خطا، اگر بخواهید «داشبورد میانای کاربر Edge» یا هریک از داشبوردهای تجزیهوتحلیل را مشاهده کنید، پیام خطای گزارش زمانبندیشده را برای سازمان تازه ایجادشده مشاهده خواهید کرد.
پیام خطا
وقتی برای ایجاد سازمان جدید، اسکریپت apigee-provision را اجرا میکنید، ممکن است پیام خطای زیر را ببینید:
!!!! Error !!!!
HTTP STATUS CODE: 400
{
"code" : "dataapi.service.PGFoundInMultipleGroups",
"message" : "dataapi.service.PGFoundInMultipleGroups",
"contexts" : [ ]
}
حتی اگر این خطا را دریافت کردید، پساز خروج از اسکریپت آمادهسازی میتوانید در سازمان تازه ایجادشده فعالیت کنید. بااینحال، وقتی تلاش میکنید «داشبورد میانای کاربر Edge» را مشاهده کنید، پیام خطای زیر را برای سازمان تازه ایجادشده مشاهده خواهید کرد:
The report timed out
Try again with a smaller date range or a larger aggregation interval.
در اینجا نماگرفتی از خطا نشان داده شده است:

علل احتمالی
| علت | شرح | دستورالعملهای عیبیابی برای |
| راهاندازی «گروههای AX» متعدد | چندین گروه تجزیهوتحلیل با مجموعه یکسانی از سرورهای Postgres ایجاد شده است. | کاربران Edge Private Cloud |
علت: راهاندازی چند «گروه AX»
تشخیص
«میانای برنامهسازی کاربردی مدیریت گروههای Analytics» زیر را اجرا کنید و تعیین کنید که آیا برونداد بیشاز یک گروه Analytics تعریفشده را نشان میدهد یا نه. برای مثال:
curl -u adminEmail:adminPwd http://<ms_ip>:8080/v1/analytics/groups/axبرونداد نمونه که دو گروه تجزیهوتحلیل را نشان میدهد
{ "name":"axgroup-001", "properties":{ }, "scopes":[ ], "uuids":{ "qpid-server":[ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "postgres-server":[ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ] }, "consumer-groups":[ { "name":"consumer-group-001", "consumers":[ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "datastores":[ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "properties":{ } } ], "data-processors":{ } }, { "name":"axgroup001", "properties":{ "consumer-type":"ax" }, "scopes":[ "017pdspoint~dev", "010test~dev", "019charmo~dev", "009gcisearch1~dev", "000fj~trial-fjwan", "009dekura~dev", "008pisa~dev", "004fjadrms~dev", "018k5billing~dev", "004study14~dev", "001teama~dev", "005specdb~dev", "test~dev", "000fj~prod-fjwan", "012pjweb~dev", "020workflow~dev", "007ikou~prod-fjwan", "003asano~dev", "013mims~dev", "006studyhas~dev", "006efocus~dev", "002wfproto~dev", "008murahata~dev", "016mediaapi~dev", "015skillnet~dev", "014aclmanager~dev", "010fjppei~dev", "000fj~trial", "003esupport~dev", "000fj~prod", "005ooi~dev", "test~elb1", "007fjauth~dev", "011osp~dev", "002study~dev", "999test~dev" ], "uuids":{ "qpid-server":[ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "aries-datastore":[ ], "postgres-server":[ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "dw-server":[ ] }, "consumer-groups":[ { "name":"consumer-group-001", "consumers":[ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "datastores":[ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "properties":{ } } ], "data-processors":{ } }
این برونداد نشان میدهد که دو گروه تجزیهوتحلیل axgroup-001 و axgroup001 وجود دارد.
بررسی کنید تا مطمئن شوید همه گروههای تجزیهوتحلیل دارای محدودههای تعریفشده باشند.
در برونداد گروههای تجزیهوتحلیل نمونه که در بالا نشان داده شده است، گروه تجزیهوتحلیل axgroup-001 هیچ محدودهای تعریف نکرده است، اما همچنان سرورهای Postgres را بهعنوان مخزن داده تعریف کرده است.
فرمان آمار صف Qpid زیر را در سرورهای Qpid اجرا کنید و تأیید کنید که هیچ پیامی برای گروه تجزیهوتحلیل خاص شناساییشده در مرحله ۲ وجود ندارد.
qpid-stat -qنمونه آمار صف Qpid
آمار صف Qpid زیر نشان میدهد که هیچ پیامی برای صف گروه تجزیهوتحلیل خاص از مثال ذکرشده در بالا (axgroup-001) وجود ندارد:
صف dur autoDel excl msg msgIn msgOut بایت bytesIn bytesOut cons ملزم کردن 140995fe-71a7-4000-a1f4-71b7a951da7f:0.0 س س 0 0 0 0 0 0 1 2 ax-q-axgroup-001-consumer-group-001 س 0 0 0 0 0 0 12 2 ax-q-axgroup-001-consumer-group-001-dl س 0 0 0 0 0 0 0 2 ax-q-axgroup001-consumer-group-001 س 0 ۲۴۱ هزار ۲۴۱ هزار 0 ۲۱٫۷ گرم ۲۱٫۷ گرم 12 2 ax-q-axgroup001-consumer-group-001-dl س 323 323 0 ۵۲٫۴ میلیون ۵۲٫۴ میلیون 0 0 2 ازآنجاییکه هیچ پیام/ترافیکی برای گروه تجزیهوتحلیل خاص axgroup-001 وجود ندارد، خطای «گزارش زمانبندی شد» را در داشبورد «واسط کاربر Edge» یا در داشبوردهای تجزیهوتحلیل مشاهده میکنید.
وضوح
برای حل کردن این مشکل، axgroup را که هیچ دامنهای ندارد و هیچ ترافیکی دریافت نمیکند حذف کنید.
برای حذف axgroup، مراحل زیر را دنبال کنید :
مرحله ۱: مصرفکنندگان را برای axgroup خاص حذف کنید.
از API مدیریت زیر برای برداشتن هریک از مصرفکنندگان از
axgroupاستفاده کنید:curl -v -u admin@email.com:password -X DELETE -H 'Accept:application/json' -H 'Content-Type:application/json' 'http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/consumer-groups/{consumer-group-name}/consumers/{uuid-of the consumer}'اگر مصرفکنندگان متعددی وجود دارد، همان فراخوانی API بالا را تکرار کنید و شناسه UUID هر مصرفکننده را در فراخوانی API جداگانهای ذکر کنید.
برای مثال نشاندادهشده در بالا، میانای برنامهسازی کاربردی زیر مصرفکننده با UUID
5c1e9690-7b58-499a-a4bb-d54454474b8f:را برمیداردcurl -v -X DELETE -H 'Accept:application/json' -H 'Content-Type:application/json' 'http://localhost:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/5c1e9690-7b58-499a-a4bb-d54454474b8f' { "name" : "axgroup-001", "properties" : { }, "scopes" : [ ], "uuids" : { "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "properties" : { } } ], "data-processors" : { } * Connection #0 to host localhost left intact * Closing connection #0 }همان API را دوباره اجرا کنید تا مصرفکننده دیگری را که شناسه UUID آن در مثال کنونی 7794c428-e553-4ed2-843d-69f93bbec8a3 است حذف کنید.
مرحله ۲ : برداشتن گروههای مصرفکننده
از API مدیریت زیر برای برداشتن گروههای مصرفکننده از
axgroupخاص استفاده کنید:curl -v -u admin@email.com:password -X DELETE 'http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/consumer-groups/{consumer-group-name}'مثال:
میانای برنامهسازی کاربردی زیر نام گروه مصرفکننده consumer-group-001: را حذف میکند:
curl -v -X DELETE 'http://localhost:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001' { "name" : "axgroup-001", "properties" : { }, "scopes" : [ ], "uuids" : { "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ ], "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "properties" : { } } ], "data-processors" : { } * Connection #0 to host localhost left intact * Closing connection #0 }
مرحله ۳: حذف qpid-servers از axgroup
از API مدیریت زیر برای حذف
qpid-serversازaxgroupخاص استفاده کنید.curl -X DELETE -u admin@email.com "http://localhost:8080/v1/analytics/groups/ax/{axgroup-name}/servers?uuid={qpid-server-uuid}type=qpid-server" -H "Content-type: application/json"اگر چندین سرور Qpid وجود دارد، همان فراخوانی API را دوباره اجرا کنید.
مثال:
از API زیر برای حذف سرور Qpid با UUID 7794c428-e553-4ed2-843d-69f93bbec8a3 در مثال کنونی استفاده کنید:
curl -X DELETE "http://localhost:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=7794c428-e553-4ed2-843d-69f93bbec8a3&type=qpid-server" -H "Content-type: application/json" { "name" : "axgroup-001", "properties" : { }, "scopes" : [ ], "uuids" : { "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f" ], "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ ], "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "properties" : { } } ], "data-processors" : { } }
مرحله ۴: حذف سرورهای postgres از axgroup
اگر فقط یک سرور Postgres وجود دارد، از API مدیریت زیر برای حذف سرور Postgres استفاده کنید:
curl -v -X DELETE -H 'Accept:application/json' "http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/servers?uuid={postgres-server-uuid}&type=postgres-server&force=true"اگر تنظیمات اصلی و برده Postgres دارید، از API مدیریت زیر برای حذف سرورهای Postgres استفاده کنید
curl -v -X DELETE -H 'Accept:application/json' "http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/servers?uuid={postgres-master-uuid,postgres-slave-uuid}&type=postgres-server&force=true"مثال:
در مثال نشاندادهشده در بالا، سرورهای Postgres اصلی و فرعی وجود دارد، بنابراین میتوانید از API زیر برای حذف سرورهای Postgres استفاده کنید:
curl -v -X DELETE -H 'Accept:application/json' "http://localhost:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=3b28b790-ec4e-45c5-a8d0-6d6f2088da65,750cd8ba-1799-4dfb-8c74-548010e95e5e&type=postgres-server&force=true" { "name" : "axgroup-001", "properties" : { }, "scopes" : [ ], "uuids" : { "qpid-server" : [ ], "postgres-server" : [ ] }, "consumer-groups" : [ ], "data-processors" : { } * Connection #0 to host localhost left intact * Closing connection #0 }
مرحله ۵: برداشتن گروه تجزیهوتحلیل
برای برداشتن گروه تجزیهوتحلیل، از API مدیریت زیر استفاده کنید:
curl -v -X DELETE "http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}"مثال:
curl -v -X DELETE "http://localhost:8080/v1/analytics/groups/ax/axgroup-001" { "properties" : { }, "scopes" : [ ], "uuids" : { }, "consumer-groups" : [ ], "data-processors" : { } * Connection #0 to host localhost left intact * Closing connection #0 }
مرحله ۶: بررسی کنید که آیا گروه بهطور کامل حذف شده است یا خیر
از API مدیریت زیر برای بررسی اینکه گروه تجزیهوتحلیل خاص بهطور کامل برداشته شده است یا نه استفاده کنید:
curl -v -u admin@email.com -X GET "http://{mgmt-server-host}:8080/v1/analytics/groups/axمثال:
curl localhost:8080/v1/analytics/groups/ax [ { "name" : "axgroup001", "properties" : { "consumer-type" : "ax" }, "scopes" : [ "017pdspoint~dev", "010test~dev", "019charmo~dev", "009gcisearch1~dev", "000fj~trial-fjwan", "009dekura~dev", "008pisa~dev", "004fjadrms~dev", "018k5billing~dev", "004study14~dev", "001teama~dev", "005specdb~dev", "test~dev", "000fj~prod-fjwan", "012pjweb~dev", "020workflow~dev", "007ikou~prod-fjwan", "003asano~dev", "013mims~dev", "006studyhas~dev", "006efocus~dev", "002wfproto~dev", "016mediaapi~dev", "015skillnet~dev", "014aclmanager~dev", "010fjppei~dev", "000fj~trial", "003esupport~dev", "000fj~prod", "005ooi~dev", "test~elb1", "007fjauth~dev", "011osp~dev", "002study~dev" ], "uuids" : { "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "aries-datastore" : [ ], "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "dw-server" : [ ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ], "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ], "properties" : { } } ], "data-processors" : { } } ]توجه داشته باشید که در برونداد بالا، هیچ اطلاعاتی مربوط به گروه تجزیهوتحلیل خاص axgroup-001 وجود ندارد. این ایمیل تأیید میکند که axgroup-001 بهطور کامل برداشته شده است.
مرحله ۷: بازراهاندازی فرایندها
فرایندهای زیر در ماشینهای Qpid و Postgres:
- apigee-qpidd را بازراهاندازی کنید.
- بازراهاندازی edge-qpid-server.
- edge-postgres-server را بازراهاندازی کنید.
- apigee-postgresql را بازراهاندازی کنید.
مرحله ۸: درستیسنجی
بررسی کنید که آیا دادهها در داشبوردهای تجزیهوتحلیل نشان داده میشود یا نه.
اگر مشکل همچنان ادامه داشت، به اطلاعات تشخیصی ضروری بروید.
باید اطلاعات تشخیص خرابی را جمعآوری کند
اگر مشکل حتی پساز دنبال کردن دستورالعملهای بالا برطرف نشد، لطفاً اطلاعات تشخیصی زیر را جمعآوری کنید. با پشتیبانی Apigee Edge تماس بگیرید و اطلاعات جمعآوریشده را با آنها همرسانی کنید.
- راهاندازی معماری نصب «ابر خصوصی» شما (تعداد میزبانان راهاندازی، تعداد هریک از مؤلفهها).
برونداد فرمانهای زیر:
گروه Analytics
curl -u sysadminEmail:sysadminPwd http://{mgmt-server-host}:8080/v1/analytics/groups/axآمار صف Qpid در هریک از ماشینهای Qpid
qpid-stat -qوضعیت Analytics
curl -u sysadminEmail:sysadminPwd http://{mgmt-server-host}:8080/v1/organizations/{org-name}/environments/{environment-name}/provisioning/axstatus