وضعیت آپلود و خطاها را بررسی کنید

می‌توانید وضعیت ابرداده‌ها و بارگذاری‌های داده‌های زمان اجرا را در هر زمانی با پرس و جو از Apigee API Hub برای نقطه پایانی وضعیت محلی رابط ابر خصوصی بررسی کنید.

بررسی وضعیت آپلود

از دستور curl زیر در ماشین مجازی که کانکتور Apigee API Hub for Private Cloud را اجرا می کند استفاده کنید:

curl localhost:8080/v1/uapim/status

    {
      "APIMetadata": [
        {
          "organization": "test",
          "environment": "dev",
          "stage": "BULK_TRANSFER",
          "totalDeployments": 100,
          "completed": 10,
          "lastUpdated": "04-16-2025 00:56:45",
          "errors": 0
        },
        {
          "organization": "test",
          "environment": "prod",
          "stage": "STREAMING",
          "pendingUploads": 10,
          "errors": 1,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "stage": "Yet to Start",
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ],
      "RuntimeData": [
        {
          "organization": "test",
          "environment": "dev",
          "errorCount": 2,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test",
          "environment": "prod",
          "errorCount": 4,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "errorCount": 0,
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ]
    }

خروجی بینش هایی را در مورد:

• فراداده API : وضعیت آپلودهای فراداده API، از جمله سازمان، محیط، مرحله فعلی (به عنوان مثال، "انتقال انبوه"، "جریان"، "هنوز شروع نشده")، بارگذاری کل/تکمیل شده/در انتظار، تعداد خطاها و زمان آخرین به روز رسانی.
• فراداده زمان اجرا : وضعیت آپلود داده های زمان اجرا، نشان دادن سازمان، محیط، تعداد خطاها و زمان آخرین به روز رسانی.

مشکلات رایج و مراحل عیب یابی

اگر با مشکلاتی مواجه شدید، به گزارش‌های رابط و نقطه پایانی وضعیت مراجعه کنید. فایل لاگ اصلی برای رابط هاب Apigee در /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log قرار دارد.

1. Apigee API Hub for Private Cloud کانکتور راه اندازی نمی شود :
   • بررسی گزارش‌ها : /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log را برای پیام‌های خطای مرتبط با پیکربندی بررسی کنید.
   • تأیید تنظیمات : همه تنظیمات پیکربندی شده را در uapim-connector.properties و متغیرهای محیطی دوبار بررسی کنید.
   • دسترسی Pub/Sub : در گزارش‌ها بررسی کنید که آیا opdk-connector می‌تواند به موضوعات Pub/Sub ارائه شده دسترسی داشته باشد.
   • دسترسی به سرور مدیریت : اگر opdk-connector بتواند با موفقیت سرور مدیریت Apigee را با URL و اعتبارنامه‌های داده شده فراخوانی کند، گزارش‌ها را بررسی کنید.
   • زمان راه‌اندازی : اگر هزاران استقرار در محیط Apigee شما وجود داشته باشد، کانکتور هاب Apigee می‌تواند تقریباً 20 تا 30 دقیقه طول بکشد تا راه‌اندازی شود.
2. فراداده API در هاب API نمایش داده نمی شود :
   • گزارش‌های اتصال : گزارش‌های opdk-connector را بررسی کنید تا ببینید آیا می‌تواند به موضوع Pub/Sub ابرداده API دسترسی داشته باشد و با سرور مدیریت تماس بگیرد.
   • وضعیت آپلود : خروجی curl localhost:8080/v1/uapim/status بررسی کنید. به دنبال بخش APIMetadata باشید.
     • آیا lastUpdated اخیر است؟
     • آیا تعداد errorCount به طور مداوم در حال افزایش است؟
     • در چه مرحله ای است؟
   • استثناها/خطاها : گزارش‌ها را برای هر گونه استثنا یا خطای مربوط به پردازش فراداده جستجو کنید.
3. داده های زمان اجرا در هاب API نمایش داده نمی شوند :
   • گزارش های اتصال : بررسی کنید که آیا کانکتور opdk می تواند به موضوع Pub/Sub زمان اجرا دسترسی داشته باشد و با سرور مدیریت تماس بگیرد.
   • وضعیت آپلود : از دستور curl localhost:8080/v1/uapim/status استفاده کنید. روی بخش RuntimeData تمرکز کنید.
     • آیا lastUpdated اخیر است؟
     • آیا تعداد errorCount به طور مداوم در حال افزایش است؟
   • استثناها/خطاها : به دنبال هر گونه استثنا یا خطا در گزارش های مربوط به پردازش داده های زمان اجرا باشید.
   • پیکربندی پردازشگر پیام : اطمینان حاصل کنید که message-processor-communication.properties روی همه MPها برای نوشتن دوگانه به درستی پیکربندی شده است و MPها مجدداً راه اندازی شده اند.
   • نصب NFS : بررسی کنید که پایه NFS به درستی پیکربندی شده و هم توسط MP و هم رابط UAPIM قابل دسترسی است.
4. پروکسی مستقر شده است، اما اطلاعات موجود در هاب API دقیق نیست :
   • زمان انتظار : چند دقیقه فرصت دهید تا داده ها منتشر شوند.
   • گزارش‌ها : گزارش‌های opdk-connector را برای اطلاعات در مورد پراکسی‌های آپلود شده بررسی کنید. این می تواند به تشخیص اینکه آیا کانکتور در حال پردازش رویدادهای استقرار است کمک می کند.