Loading...
Back to blog. Article language: BN EN ES FR HI ID PT RU UR VI ZH

প্রক্সি এরর কোড এবং তা সমাধানের পূর্ণাঙ্গ নির্দেশিকা

যুক্তরাষ্ট্রে যেকোনো SaaS প্ল্যাটফর্ম, ই-কমার্স পাইপলাইন বা অ্যানালিটিক্স স্ট্যাক পরিচালনাকারী প্রকৌশলী কোনো না কোনো সময় বাধার সম্মুখীন হয়েছেন — একটি রিকোয়েস্ট ব্যর্থ হয়, ট্রাফিক কমে যায় এবং লগে একটি রহস্যময় তিন অঙ্কের কোড দেখা দেয়। প্রতিটি কোড কী নির্দেশ করছে তা জানা থাকলে পাঁচ মিনিটের সমাধান আর তিন ঘণ্টার বিভ্রাটের মধ্যে পার্থক্য তৈরি করা সম্ভব। এই নির্দেশিকাটি প্রক্সি এরর নির্ণয়ের মূল বিষয়গুলো কভার করে, যাতে আপনার পরিকাঠামো স্থিতিশীল থাকে এবং আপনার টিম অন্ধকারে ঢিল ছোড়া বন্ধ করতে পারে।

প্রক্সি এরর কোডগুলোর অর্থ

প্রক্সি এরর হলো এমন এক রেসপন্স কোড যা তখন তৈরি হয় যখন একটি রিকোয়েস্ট একটি ইন্টারমিডিয়ারি সার্ভার বা প্রক্সির মধ্য দিয়ে যাওয়ার সময় কোনো সমস্যার সম্মুখীন হয়। এই প্রক্সি কোডগুলো ওয়েবে ব্যবহৃত HTTP স্ট্যাটাস কোডের কনভেনশন অনুসরণ করে, তবে এগুলোতে অতিরিক্ত তথ্য থাকে: এগুলো শুধুমাত্র যে সমস্যা হয়েছে তা-ই জানায় না, বরং রিকোয়েস্ট লাইফসাইকেলের কোথায় সমস্যাটি ঘটেছে তাও নির্দেশ করে।

রিকোয়েস্ট প্রবাহের সাথে তুলনা করলে প্রক্সি এররের অর্থ আরও পরিষ্কার হয়। একজন ক্লায়েন্ট একটি রিকোয়েস্ট পাঠায় → প্রক্সি তা গ্রহণ করে → প্রক্সি আপস্ট্রিম সার্ভারে তা ফরোয়ার্ড করে → একটি রেসপন্স ফিরে আসে। প্রতিটি ধাপ স্বাধীনভাবে ব্যর্থ হতে পারে এবং প্রতিটি ব্যর্থতার ধরন ভিন্ন ভিন্ন কোড তৈরি করে।

রিকোয়েস্ট লাইফসাইকেল ওভারভিউ:

  • ক্লায়েন্ট রিকোয়েস্ট শুরু করে
  • প্রক্সি রিকোয়েস্ট গ্রহণ ও যাচাই করে
  • প্রক্সি প্রমাণীকরণ (authenticate) করে এবং অ্যাক্সেস রুল প্রয়োগ করে
  • প্রক্সি লক্ষ্য সার্ভারে ফরোয়ার্ড করে
  • আপস্ট্রিম সার্ভার রেসপন্স করে
  • প্রক্সি ক্লায়েন্টের কাছে রেসপন্সটি ফিরিয়ে দেয়
বিভাগউদাহরণসমস্যার মাত্রা
ক্লায়েন্ট-সাইড এরর400, 401, 403, 407কম — রিকোয়েস্ট লেভেলে সমাধানযোগ্য
সার্ভার-সাইড এরর500, 502, 503, 504উচ্চ — পরিকাঠামো রিভিউ প্রয়োজন
নেটওয়ার্ক-লেভেল এররConnection refused, DNS failureমাঝারি — কনফিগারেশন বা রাউটিং
প্রমাণীকরণ এরর401, 407, token expiryমাঝারি — ক্রেডিয়েনশিয়াল বা পলিসি সমস্যা

প্রক্সি এররের শ্রেণীবিন্যাস

সব ব্যর্থতা সমান নয়। কিছু থাকে ক্লায়েন্ট সাইডে — ভুল হেডার, ভুল ক্রেডেনশিয়াল, অনুপস্থিত টোকেন। অন্যগুলো আপনার আপস্ট্রিম সার্ভার, নেটওয়ার্ক টপোলজি বা অমিল প্রোটোকলকে নির্দেশ করে। সঠিক সমাধানের পথে প্রথম ধাপ হলো সেগুলোকে সঠিকভাবে গ্রুপ করা।

যদি একই প্রক্সি এরর একাধিক এন্ডপয়েন্টে বারবার ঘটে, তবে সমস্যাটি প্রায় নিশ্চিতভাবে কনফিগারেশন বা রাউটিং স্তরে রয়েছে।

সমস্যাটি কোন স্তরে আছে তা বোঝা নির্ণয় সময় বাঁচায়। একটি প্রক্সি কানেকশন এরর এবং প্রক্সি অথেন্টিকেশন এরর সম্পূর্ণ আলাদা, এবং একটিকে অন্যটির মতো করে সমাধান করার চেষ্টা করলে ঘণ্টার পর ঘণ্টা নষ্ট হয়।

এরর গ্রুপসাধারণ কোডপ্রাইমারি কারণ
ক্লায়েন্ট-সাইড400, 401, 403দুর্বল রিকোয়েস্ট, ভুল প্রমাণীকরণ
প্রমাণীকরণ401, 407অনুপস্থিত বা মেয়াদোত্তীর্ণ ক্রেডেনশিয়াল
সার্ভার-সাইড500, 502, 503, 504আপস্ট্রিম ব্যর্থতা, ওভারলোড
নেটওয়ার্ক-লেভেলN/A (নন-HTTP)ডিএনএস ব্যর্থতা, পোর্ট ব্লকিং, টিএলএস সমস্যা

4xx প্রক্সি এররসমূহ ব্যাখ্যা করা

4xx রেঞ্জটি ক্লায়েন্ট বা অ্যাক্সেস কন্ট্রোল স্তর থেকে উদ্ভূত সমস্যা নির্দেশ করে। এগুলো সাধারণত খুব দ্রুত ডায়াগনস্টিক এবং সমাধান করা যায়, কারণ এগুলোর জন্য আপনার সার্ভার পরিকাঠামো স্পর্শ করার প্রয়োজন হয় না — শুধুমাত্র আপনার রিকোয়েস্ট কনফিগারেশন বা অথেন্টিকেশন সেটআপ ঠিক করলেই হয়।

প্রক্সি এররের অর্থ বোঝা প্রকৌশলীদের ক্লায়েন্ট মিসকনফিগারেশন এবং প্রকৃত আপস্ট্রিম ব্যর্থতার মধ্যে পার্থক্য করতে সাহায্য করে।

400 এবং 401 এরর

একটি 400 এরর — ব্যাড রিকোয়েস্ট — মানে প্রক্সি এমন কিছু পেয়েছে যা解析 (parse) করতে পারেনি। সাধারণ কারণগুলোর মধ্যে রয়েছে ত্রুটিপূর্ণ হেডার, ভুল এনকোডিং বা অসমর্থিত HTTP ভার্সন। রিকোয়েস্ট নিজেই সমস্যা, সার্ভার নয়।

একটি প্রক্সি এরর মানে ইন্টারমিডিয়ারি সার্ভার আপনার রিকোয়েস্ট প্রসেস বা ফরোয়ার্ড করার সময় সমস্যার সম্মুখীন হয়েছে।

একটি 401 এরর মানে অনুপস্থিত বা অবৈধ ক্রেডেনশিয়াল। প্রক্সি বা আপস্ট্রিম সার্ভারের অথেন্টিকেশন প্রয়োজন, এবং যা পাঠানো হয়েছে তা হয় অনুপস্থিত ছিল অথবা যাচাইকরণে উত্তীর্ণ হয়নি। এটি একটি প্রক্সি অথেন্টিকেশন এরর — সেশনের সাথে কোনো স্বীকৃত পরিচয় যুক্ত নেই।

আপনি যদি জানতে চান প্রক্সি এরর কী, সংক্ষেপে উত্তর হলো: এটি এমন একটি স্ট্যাটাস কোড যা তৈরি হয় যখন একটি প্রক্সি সার্ভার ক্লায়েন্টের পক্ষ থেকে কোনো রিকোয়েস্ট সম্পন্ন করতে ব্যর্থ হয়।

403 এবং 407 এরর

403 মানে অ্যাক্সেস ডিনাইড — পরিচয়টি স্বীকৃত কিন্তু অনুমতি নেই। এটি সাধারণত প্রক্সি লেভেলে সেট করা অ্যাক্সেস পলিসিকে প্রতিফলিত করে: আইপি হোয়াইটলিস্ট, ভূ-নিষেধাজ্ঞা (geo-restrictions) বা রোল-ভিত্তিক নিয়ম। রিকোয়েস্ট প্রক্সিতে পৌঁছেছে, অথেন্টিকেশন হয়তো সফল হয়েছে, কিন্তু পলিসি তাকে বাধা দিয়েছে।

407 বিশেষভাবে প্রক্সি অথেন্টিকেশন রিকোয়ার্ড এরর। 401 এর বিপরীতে, যা অরিজিন সার্ভারের ক্ষেত্রে প্রযোজ্য, 407 ক্লায়েন্টকে জানায় যে প্রক্সিটির নিজেরই কোনো কিছু ফরোয়ার্ড করার আগে ক্রেডেনশিয়াল প্রয়োজন। এটি এন্টারপ্রাইজ পরিবেশ এবং কর্পোরেট নেটওয়ার্ক সেটআপে সাধারণ, যেখানে প্রক্সি একটি গেটওয়ে হিসেবে কাজ করে।

প্রক্সি এরর দুটি ব্রড ক্যাটাগরিতে বিভক্ত — ক্লায়েন্ট কনফিগারেশন ভুলের কারণে হওয়া এবং আপস্ট্রিম পরিকাঠামোর সমস্যার কারণে হওয়া।

4xx এরর কীভাবে সমাধান করবেন

সার্ভার কনফিগারেশন স্পর্শ করার আগে রিকোয়েস্টটি দিয়ে শুরু করুন। বেশিরভাগ 4xx সমস্যা ক্লায়েন্ট বা ক্রেডেনশিয়াল লেভেলে সমাধান হয়ে যায়।

ডায়াগনস্টিক চেকলিস্ট:

  • রিকোয়েস্ট হেডার সঠিকভাবে ফরম্যাট করা আছে এবং পূর্ণাঙ্গ কিনা তা যাচাই করুন
  • অথেন্টিকেশন টোকেন উপস্থিত, বৈধ এবং মেয়াদোত্তীর্ণ নয় কিনা তা নিশ্চিত করুন
  • ক্লায়েন্ট আইপি অনুমোদিত হোয়াইটলিস্টে আছে কিনা তা পরীক্ষা করুন
  • রোল বা ভূ-নিষেধাজ্ঞার জন্য প্রক্সি অ্যাক্সেস পলিসি রিভিউ করুন
  • ব্যর্থতার স্তর আলাদা করতে প্রক্সি বাইপাস করে সরাসরি এন্ডপয়েন্ট পরীক্ষা করুন
  • 407 এরর হলে নিশ্চিত করুন প্রক্সি ক্রেডেনশিয়াল অরিজিন ক্রেডেনশিয়াল থেকে আলাদাভাবে পাঠানো হচ্ছে

5xx প্রক্সি এররসমূহ ব্যাখ্যা করা

5xx ক্লাসটি আরও গুরুতর। এই কোডগুলো নির্দেশ করে যে প্রক্সি বা আপস্ট্রিম সার্ভার এমন ব্যর্থতার সম্মুখীন হয়েছে যা সে সমাধান করতে পারেনি। ক্লায়েন্ট একটি বৈধ রিকোয়েস্ট পাঠিয়েছিল — সমস্যাটি পরিকাঠামোর দিকে।

উৎপাদন পরিবেশে বেশিরভাগ প্রক্সি এরর সঠিক অথেন্টিকেশন সেটআপ এবং ডিএনএস কনফিগারেশন দিয়ে প্রতিরোধযোগ্য।

500 এবং 502 এরর

500 একটি সাধারণ ইন্টারনাল সার্ভার এরর। আপস্ট্রিম সার্ভার রিকোয়েস্টটি পেয়েছিল কিন্তু প্রসেস করতে ব্যর্থ হয়েছে। এটি একটি ক্র্যাশড প্রসেস, আনহ্যান্ডেলড এক্সেপশন বা ভুল কনফিগার করা অ্যাপ্লিকেশন হতে পারে। আপস্ট্রিম সার্ভারের লগ এখানে প্রাথমিক ডায়াগনস্টিক টুল।

একই এন্ডপয়েন্টে বারবার প্রক্সি এরর আসা মানে এটি একটি কাঠামোগত সমস্যা, কোনো সাময়িক গ্লিচ নয়।

502 ব্যাড গেটওয়ে এরর মানে প্রক্সি আপস্ট্রিম সার্ভার থেকে একটি রেসপন্স পেয়েছিল, কিন্তু সেই রেসপন্সটি অবৈধ বা অসম্পূর্ণ ছিল। এটি একটি ধ্রুপদী প্রক্সি গেটওয়ে এরর — আপস্ট্রিম ওভারলোড হতে পারে, আংশিক নিচে (down) থাকতে পারে বা ত্রুটিপূর্ণ ডেটা ফেরত দিতে পারে। যদি আপনার আপস্ট্রিম একটি ক্লাস্টার হয়, তবে 502 প্রায়ই নির্দেশ করে যে এক বা একাধিক নোড অস্বাস্থ্যকর।

প্রক্সি এরর ঠিক কী? এটি প্রক্সি লেভেল থেকে একটি সিগন্যাল যে ক্লায়েন্টের রিকোয়েস্ট এবং সার্ভারের রেসপন্সের মধ্যে কিছু একটা ভেঙে গেছে — এবং এটি সবসময় স্ট্যাকের একটি নির্দিষ্ট স্তরকে নির্দেশ করে।

503 এবং 504 এরর

503 সার্ভিস আনঅ্যাভেইলেবল মানে আপস্ট্রিম সার্ভার সাময়িকভাবে রিকোয়েস্ট হ্যান্ডেল করতে পারছে না — সাধারণত ওভারলোড বা পূর্বনির্ধারিত রক্ষণাবেক্ষণের কারণে। সার্ভারটি রিচযোগ্য কিন্তু সক্ষমতা শেষ হয়ে যাওয়ায় সংযোগ প্রত্যাখ্যান করছে।

একটি প্রক্সি এরর রিকোয়েস্ট চেইনের যেকোনো বিন্দুতে দেখা দিতে পারে — ডিএনএস রেজোলিউশন থেকে আপস্ট্রিম রেসপন্স ডেলিভারি পর্যন্ত।

504 গেটওয়ে টাইমআউট ঘটে যখন প্রক্সি একটি রিকোয়েস্ট ফরোয়ার্ড করে কিন্তু আপস্ট্রিম রেসপন্স দিতে অনেক সময় নেয়। এটি একটি প্রক্সি টাইমআউট এরর: প্রক্সি অপেক্ষা করা বন্ধ করে দেয় এবং ক্লায়েন্টকে 504 দেয়। উচ্চ ল্যাটেন্সি, ধীর ডাটাবেস কোয়েরি বা প্রক্সি ও আপস্ট্রিমের মধ্যে নেটওয়ার্ক কনজেশন এর সাধারণ কারণ।

5xx এররের জন্য পরিকাঠামো সমাধান

5xx এরর সমাধান করার জন্য প্রক্সির বাইরে তাকাতে হয়। প্রক্সি সাধারণত শুধু বার্তাবাহক — মূল সমস্যাটি রাউটিং, লোড ডিস্ট্রিবিউশন বা আপস্ট্রিম সক্ষমতায় থাকে।

কোডকারণসমাধানের অগ্রাধিকার
500আপস্ট্রিম অ্যাপ্লিকেশন ক্র্যাশ বা ভুল কনফিগারেশনউচ্চ
502অবৈধ আপস্ট্রিম রেসপন্স, নোড ব্যর্থতাউচ্চ
503সার্ভার ওভারলোড, রক্ষণাবেক্ষণমাঝারি
504আপস্ট্রিম টাইমআউট, উচ্চ ল্যাটেন্সিমাঝারি—উচ্চ

সমাধানের ধাপসমূহ:

  • এক্সেপশন বা প্রসেস ব্যর্থতার জন্য অবিলম্বে আপস্ট্রিম সার্ভার লগ পরীক্ষা করুন
  • লোড ব্যালেন্সার হেলথ চেক রিভিউ করুন — অস্বাস্থ্যকর নোডগুলো রোটেশন থেকে সরিয়ে ফেলুন
  • ইভেন্টের সময় বনাম সাধারণ সময়ে প্রক্সি ও আপস্ট্রিমের মধ্যে রেসপন্স টাইম পরিমাপ করুন
  • যদি লোড কারণ হয় তবে আপস্ট্রিম সক্ষমতা বাড়ান (horizontally scale)
  • যদি আপস্ট্রিম প্রসেস সত্যিকার অর্থে ধীর হয় তবে প্রক্সি টাইমআউট থ্রেশহোল্ড সমন্বয় করুন

নেটওয়ার্ক এবং ডিএনএস সম্পর্কিত এরর

সব প্রক্সি ব্যর্থতা পরিষ্কার HTTP কোড হিসেবে দেখায় না। কিছু HTTP আসার আগেই ঘটে — নেটওয়ার্ক বা ডিএনএস স্তরে। এগুলো শনাক্ত করা সবচেয়ে কঠিন কারণ এরা স্ট্যান্ডার্ড স্ট্যাটাস রেসপন্স দেয় না।

প্রক্সি এরর দেখা দিলে প্রথম কাজ হলো সমস্যাটি ক্লায়েন্ট সাইডে নাকি পরিকাঠামো সাইডে তা যাচাই করা।

নেটওয়ার্ক ডায়াগনস্টিক চেকলিস্ট:

  • ✅ ডিএনএস কনফিগারেশন পরীক্ষা করুন — নিশ্চিত করুন আপস্ট্রিম হোস্টনাম প্রক্সির পরিবেশ থেকে সঠিকভাবে রেজলভ হচ্ছে
  • ✅ পোর্টের প্রাপ্যতা যাচাই করুন — নিশ্চিত করুন টার্গেট পোর্ট খোলা আছে এবং ফায়ারওয়াল নিয়মে ব্লক করা নেই
  • ✅ প্যাকেট লস মনিটর করুন — প্রক্সি ও আপস্ট্রিমের মধ্যে দীর্ঘস্থায়ী প্যাকেট লস ক্যাসকেডিং টাইমআউট ঘটায়
  • ❌ ল্যাটেন্সি স্পাইক উপেক্ষা করবেন না — এমনকি সামান্য ল্যাটেন্সি বৃদ্ধিও ডাউনস্ট্রিম 504 এবং কানেকশন রিসেট ঘটাতে পারে
  • 💡 ট্রাসেরাউট (traceroute) এবং ডিআইজি (dig) কমান্ড প্রক্সি হোস্ট থেকে চালান, আপনার লোকাল মেশিন থেকে নয় — নেটওয়ার্ক পাথ ভিন্ন হয়

অথেন্টিকেশন এবং আইপি অথরাইজেশন সমস্যা

বারবার হওয়া প্রক্সি এররগুলোর বড় একটি অংশ সার্ভার ব্যর্থতার চেয়ে অথেন্টিকেশন ও অথরাইজেশন কনফিগারেশনের সমস্যার সাথে সম্পর্কিত। মেয়াদোত্তীর্ণ টোকেন, ভুল ক্রেডেনশিয়াল বা আইপি ঠিকানা যা অনুমোদিত তালিকায় যোগ করা হয়নি, সবই এমন এরর তৈরি করে যা দেখতে অ্যাক্সেস সমস্যার মতো কিন্তু আসলে সেটআপের ভুল।

আইপি অথরাইজেশন ব্যর্থতার কারণে প্রক্সি অ্যাক্সেস ডিনাইড এরর অটোমেটেড পাইপলাইনে খুব সাধারণ। একটি নতুন ডিপ্লয়মেন্ট হয়তো অন্য আইপি থেকে রান করছে বা ক্লাউড ইনস্ট্যান্স পুনরায় অ্যাসাইন হয়েছে — আর হঠাৎ গতকাল কাজ করা রিকোয়েস্টগুলো আজ ব্লক হয়ে যাচ্ছে।

প্রক্সি এরর টাইমস্ট্যাম্প ও রিকোয়েস্ট মেটাডেটা দিয়ে লগ রাখা ভবিষ্যতের ডায়াগনস্টিক অনেক দ্রুত করে দেয়।

অথেন্টিকেশন ট্রাবলশুটিংয়ের ধাপসমূহ:

  • ক্রেডেনশিয়াল যাচাই করুন — ইউজারনেম, পাসওয়ার্ড বা এপিআই কী প্রক্সির প্রত্যাশা অনুযায়ী সঠিক কিনা তা নিশ্চিত করুন
  • আইপি অথরাইজেশন নিশ্চিত করুন — অরিজিনেটিং আইপি প্রক্সির হোয়াইটলিস্টে আছে কিনা তা পরীক্ষা করুন
  • সেশন রিস্টার্ট করুন — কিছু অথেন্টিকেশন স্টেট নিঃশব্দে মেয়াদোত্তীর্ণ হয়; একটি নতুন সেশন এগুলো সমাধান করে
  • অ্যাক্সেস লগ রিভিউ করুন — প্রক্সি লগ দেখাবে রিকোয়েস্টটি অথ লেয়ারে পৌঁছেছিল নাকি তার আগেই ব্লক হয়েছে

প্রক্সি টাইমআউট এবং ল্যাটেন্সি সমস্যা

টাইমআউট সবসময় সার্ভারের ব্যর্থতার কারণে হয় না। কখনো কখনো প্রক্সি রিকোয়েস্ট ব্যর্থ হয় কারণ আপস্ট্রিম খুব ধীর — নিচে নেমে যায়নি। ল্যাটেন্সি ও এরর রেটের সম্পর্ক সরাসরি: রেসপন্স টাইম বাড়লে টাইমআউট এরর বাড়তে থাকে।

আপনার ল্যাটেন্সি প্রোফাইল বোঝা আপনাকে সাময়িক ধীরগতি এবং কাঠামোগত বাধা চিহ্নিত করতে সাহায্য করে।

মেট্রিকঝুঁকির সূচক
গড় রেসপন্স টাইম > ২ সেকেন্ডউচ্চ 504 ঝুঁকি
P99 ল্যাটেন্সি > ৫ সেকেন্ডক্যাসকেডিং টাইমআউটের উচ্চ সম্ভাবনা
কানেকশন কিউ (Queue) গভীরতা > ৮০%503 ওভারলোড আসন্ন
ডিএনএস রেজোলিউশন সময় > ২০০ মিলিসেকেন্ডপ্রক্সি নেটওয়ার্ক এরর ঝুঁকি বৃদ্ধি
টিএলএস হ্যান্ডশেক সময় > ৫০০ মিলিসেকেন্ডলোড থাকলে হ্যান্ডশেক টাইমআউটের সম্ভাবনা

সাধারণ ভুল কনফিগারেশন

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

সবচেয়ে ঘন ঘন হওয়া ভুলগুলোর মধ্যে রয়েছে ভুল পোর্ট ব্যবহার করা — যেমন, HTTPS ট্রাফিক পোর্টের 80-তে পাঠানো, বা HTTP-কে 443-এ। প্রোটোকল অমিলও একটি সাধারণ কারণ: একটি প্রক্সি যা HTTP/1.1 এর জন্য কনফিগার করা, তা নেগোসিয়েশন ছাড়াই HTTP/2 রিকোয়েস্ট পাচ্ছে। SOCKS বনাম HTTP প্রক্সি কনফিউশন মিশ্র পরিবেশে বিশেষ করে সাধারণ, যেখানে বিভিন্ন টুল বিভিন্ন ধরণের প্রক্সি প্রত্যাশা করে।

ভুল অথেন্টিকেশন স্কোপও পরীক্ষা করা উচিত। কিছু কনফিগারেশনে প্রক্সি ক্রেডেনশিয়াল অরিজিন সার্ভারে এবং অরিজিন ক্রেডেনশিয়াল প্রক্সিতে পাঠানো হয় — উভয়ই এমনভাবে নিঃশব্দে ব্যর্থ হয় যা আপাতদৃষ্টিতে সম্পর্কহীন এরর দেখায়।

উচ্চ ট্রাফিকের সময় একটিমাত্র প্রক্সি এরর নির্ভরশীল পরিষেবাগুলোতে ক্যাসকেডিং ব্যর্থতা ট্রিগার করতে পারে।

সাময়িক বনাম কাঠামোগত এররের তুলনা

এররটি সাময়িক নাকি কাঠামোগত তা জানা আপনার রেসপন্স সম্পূর্ণ বদলে দেয়। একটি সাময়িক এরর নিজে থেকেই বা সাধারণ রিট্রাই (retry) দিয়ে ঠিক হয়ে যায়। কাঠামোগত এরর মূল কারণ সমাধান না করা পর্যন্ত বারবার ঘটতে থাকবে।

এরর ধরণসাময়িককাঠামোগত
503 ওভারলোড✅ প্রায়ই — ট্রাফিক স্পাইক❌ যদি সক্ষমতা ধারাবাহিকভাবে অপর্যাপ্ত থাকে
504 টাইমআউট✅ যদি আপস্ট্রিম সামান্য সময় ধীর ছিল❌ যদি আপস্ট্রিম বেসলাইন ল্যাটেন্সি খুব বেশি থাকে
502 ব্যাড গেটওয়ে✅ যদি একটি নোড অস্বাস্থ্যকর ছিল❌ যদি আপস্ট্রিম ক্লাস্টারে স্থাপত্যগত সমস্যা থাকে
401 অথ ব্যর্থতা❌ খুব কমই সাময়িক✅ কাঠামোগত — ক্রেডেনশিয়াল ভুল
ডিএনএস ব্যর্থতা✅ যদি TTL সম্পর্কিত হয়❌ যদি ডিএনএস প্রোভাইডারের কনফিগারেশনে ভুল থাকে
কানেকশন প্রত্যাখ্যাত❌ খুব কমই সাময়িক✅ কাঠামোগত — পোর্ট বা ফায়ারওয়াল সমস্যা

লগিং এবং মনিটরিংয়ের সেরা অনুশীলন

যা দেখতে পান না তা ঠিক করতে পারবেন না। সঠিক লগিং ছাড়া প্রক্সি এরর নির্ণয় করা অন্ধকারে ঢিল ছোঁড়ার মতো। ভালো মনিটরিং শুধু সমস্যা হলে অ্যালার্ট দেয় না — এটি কেন সমস্যা হলো তা বোঝার মতো প্রেক্ষাপট প্রদান করে।

প্রক্সি লেভেলে রিকোয়েস্ট মেটাডেটা ক্যাপচার করুন: টাইমস্ট্যাম্প, ক্লায়েন্ট আইপি, আপস্ট্রিম টার্গেট, রেসপন্স কোড এবং ল্যাটেন্সি। এগুলো একটি স্ট্রাকচার্ড ফরম্যাটে রাখুন যা আপনি কোয়েরি করতে পারেন। প্রক্সি লগের সাথে আপস্ট্রিম সার্ভার লগ কোরিলেট করুন — প্রক্সি সাইডে একটি 502 আপস্ট্রিম সাইডের একটি সংশ্লিষ্ট এন্ট্রির সাথে ম্যাপ করা উচিত।

প্রতিটি প্রক্সি এররের জন্য পরিকাঠামোর পরিবর্তন প্রয়োজন হয় না — কিছু রিকোয়েস্ট হেডার ঠিক করলেই সমাধান হয়ে যায়।

"সবচেয়ে ব্যয়বহুল বিভ্রাট হলো সেগুলো যা আপনি গ্রাহকের কাছ থেকে জানতে পারেন। দ্বিতীয় ব্যয়বহুল হলো সেগুলো যেখানে আপনার কাছে লগ আছে কিন্তু তা যথেষ্ট দ্রুত পড়তে পারছেন না।" — এমন অবকাঠামো টিমের সাধারণ অভিমত যারা গুরুতর পরিস্থিতির মধ্য দিয়ে গেছে।

💡 মনিটরিং সুপারিশ:

  • 5xx এর রেট থ্রেশহোল্ডে অ্যালার্ট সেট করুন, শুধু মোট গণনায় নয় — মূল সংখ্যার চেয়ে হঠাত বৃদ্ধি পাওয়াটা বেশি গুরুত্বপূর্ণ
  • ল্যাটেন্সি পার্সেন্টাইল (P95, P99) ট্র্যাক করুন, শুধু গড় নয় — গড় মানগুলো সবচেয়ে খারাপ ক্ষেত্রগুলোকে লুকিয়ে রাখে
  • অথেন্টিকেশন ব্যর্থতাগুলো অন্যান্য 4xx এরর থেকে আলাদাভাবে লগ করুন — এগুলো ভিন্ন ভিন্ন সমস্যা নির্দেশ করে
  • ইনসিডেন্ট রেট্রোস্পেক্টিভের জন্য অন্তত ৩০ দিন প্রক্সি লগ সংরক্ষণ করুন

ধাপে ধাপে ট্রাবলশুটিং ফ্রেমওয়ার্ক

এরর দেখা দিলে এলোমেলো অনুসন্ধানের চেয়ে একটি কাঠামোগত পদ্ধতি বেশি কার্যকর। এই ধাপগুলো ক্রমানুসারে অনুসরণ করুন এবং যেখানেই মূল কারণটি পান সেখানে থামুন।

  • কোড চিহ্নিত করুন — সঠিক এরর কোড এবং টাইমস্ট্যাম্প নোট করুন; এটি কি বিচ্ছিন্ন নাকি ব্যাপক তা পরীক্ষা করুন
  • কনফিগারেশন পরীক্ষা করুন — প্রক্সি সেটিংস রিভিউ করুন: পোর্ট, প্রোটোকল, ক্রেডেনশিয়াল এবং আইপি হোয়াইটলিস্ট
  • এন্ডপয়েন্ট পরীক্ষা করুন — প্রক্সি বাইপাস করে আপস্ট্রিমের কাছে সরাসরি রিকোয়েস্ট পাঠান, নিশ্চিত করুন এটি রিচযোগ্য এবং সঠিকভাবে সাড়া দিচ্ছে
  • ল্যাটেন্সি পরিমাপ করুন — বর্তমান রেসপন্স টাইমকে আপনার বেসলাইনের সাথে তুলনা করুন; কোড পরিবর্তন ছাড়াই ল্যাটেন্সি স্পাইক আপস্ট্রিম বা নেটওয়ার্ক সমস্যার দিকে ইঙ্গিত করে
  • স্থায়ী হলে এস্কেলেট করুন — কনফিগারেশন চেক এবং ল্যাটেন্সি পর্যালোচনার পরেও এরর পুনরাবৃত্তি হলে, লগ সংযুক্ত করে পরিকাঠামো বা প্রক্সি প্রদানকারীর সাপোর্ট টিমের কাছে এস্কেলেট করুন

কেস স্টাডি: যুক্তরাষ্ট্রে একটি SaaS প্ল্যাটফর্মে পুনরাবৃত্ত প্রক্সি এরর হ্রাস

সমস্যা: যুক্তরাষ্ট্রে অ্যানালিটিক্স পাইপলাইন পরিচালনাকারী একটি মাঝারি SaaS কোম্পানি সপ্তাহের প্রতি কর্মদিবসে সকাল ৯টা থেকে ১১টার (পূর্বাঞ্চলীয় সময়) মধ্যে 502 এবং 504 এররের ক্রমবর্ধমান স্পাইক লক্ষ্য করে। পিক আওয়ারে এররের হার ১২% পর্যন্ত উঠে যায়, যার ফলে ডেটা পাইপলাইন বিলম্বিত হয় এবং গ্রাহক-মুখী ড্যাশবোর্ড অকার্যকর হয়ে পড়ে।

বিশ্লেষণ: লগ পর্যালোচনায় দেখা যায়, প্রক্সি রিকোয়েস্টগুলো এমন একটি সিঙ্গেল আপস্ট্রিম নোডে ফরোয়ার্ড করছিল যা পিক লোডের সময় ধারাবাহিকভাবে ধীর থাকে। দীর্ঘ টিটিএলের (TTL) কারণে ডিএনএস সবসময় একই আইপি প্রদান করছিল, যার ফলে লোড ব্যালেন্সার বাইপাস হচ্ছিল। এছাড়া, অথেন্টিকেশন টোকেনগুলো মেয়াদ যাচাই ছাড়াই ক্যাশ হচ্ছিল, যার ফলে টোকেনগুলো রাতে নিঃশব্দে মেয়াদোত্তীর্ণ হয়ে গেলে মাঝে মাঝে 401 এরর তৈরি হচ্ছিল।

সমাধান: টিম ডিএনএস টিটিএল ৩০ সেকেন্ডে কমিয়ে আনে, যা আপস্ট্রিম ক্লাস্টারে সঠিক লোড ডিস্ট্রিবিউশন সক্ষম করে। তারা পাইপলাইন ক্লায়েন্টে টোকেন রিফ্রেশ লজিক যুক্ত করে। দীর্ঘস্থায়ী কোয়েরির জন্য প্রক্সি টাইমআউট থ্রেশহোল্ড ১০ সেকেন্ড থেকে বাড়িয়ে ২৫ সেকেন্ডে করা হয়।

ফলাফল: ৪৮ ঘণ্টার মধ্যে 502 এরর ৯৪% কমে যায়। 504 এরর প্রায় শূন্যে নেমে আসে। টোকেন সম্পর্কিত 401 সম্পূর্ণ দূর হয়ে যায়। ডিএনএস রেজোলিউশন টাইম এবং টোকেনের বয়স সম্পর্কে অ্যালার্ট দেওয়ার জন্য মনিটরিং যুক্ত করা হয়, যার ফলে পুনরাবৃত্তি প্রতিরোধ হয়।

প্রক্সি এরর রেফারেন্স মাস্টার টেবিল

কোডবিভাগকারণপদক্ষেপ
400ক্লায়েন্টত্রুটিপূর্ণ রিকোয়েস্ট হেডাররিকোয়েস্ট ফরম্যাট ঠিক করুন
401অথেন্টিকেশনঅনুপস্থিত বা অবৈধ ক্রেডেনশিয়ালটোকেন পুনরায় ইস্যু বা যাচাই করুন
403অ্যাক্সেসপলিসি বা আইপি ব্লকঅ্যাক্সেস নিয়ম রিভিউ করুন
407প্রক্সি অথপ্রক্সির ক্রেডেনশিয়াল প্রয়োজনপ্রক্সি অথ হেডার যোগ করুন
500সার্ভারআপস্ট্রিম অ্যাপ্লিকেশন ব্যর্থতাআপস্ট্রিম লগ পরীক্ষা করুন
502গেটওয়েঅবৈধ আপস্ট্রিম রেসপন্সআপস্ট্রিম স্বাস্থ্য পরীক্ষা করুন
503অ্যাভেইলেবিলিটিসার্ভার ওভারলোডস্কেল করুন বা রিকোয়েস্ট কিউ করুন
504টাইমআউটআপস্ট্রিম খুব ধীরটাইমআউট টিউন বা আপস্ট্রিম ল্যাটেন্সি ঠিক করুন
ডিএনএস ব্যর্থতানেটওয়ার্কহোস্টনাম রেজলভ হচ্ছে নাডিএনএস কনফিগ ঠিক করুন
কানেকশন প্রত্যাখ্যাতনেটওয়ার্কপোর্ট বন্ধ বা ব্লক করাফায়ারওয়াল এবং পোর্ট পরীক্ষা করুন
টিএলএস টাইমআউটনেটওয়ার্কএসএসএল নেগোসিয়েশন ব্যর্থতাসার্টিফিকেট ও আপস্ট্রিম টিএলএস কনফিগ পরীক্ষা করুন

ইনফ্রাস্ট্রাকচারের এরর কমাতে Nsocks প্রক্সি ব্যবহার

একটি নির্ভরযোগ্য প্রক্সি প্রদানকারী পরিকাঠামো স্তরে এররের ফ্রিকোয়েন্সি কমিয়ে দেয় — আপনার টিম তা ট্রাবলশুট করার আগেই। Nsocks স্থিতিশীল রাউটিং, স্বচ্ছ পরিকাঠামো এবং মার্কিন বাজারে ধারাবাহিক আপটাইমের উপর ভিত্তি করে তৈরি, যা SaaS এবং অ্যানালিটিক্স কাজের জন্য একটি ব্যবহারিক পছন্দ যারা অপ্রত্যাশিত প্রক্সি ব্যর্থতা সহ্য করতে পারে না।

মনিটরিং টুল যা কোড অনুযায়ী প্রক্সি এরর রেট ট্র্যাক করে, তা টিমকে পরিষ্কার ধারণা দেয় যে ব্যর্থতা কোথায় কেন্দ্রীভূত।

প্ল্যাটফর্মের রাউটিং আর্কিটেকচার এমন পরিস্থিতি কমায় যা প্রক্সি গেটওয়ে এরর এবং প্রক্সি কানেকশন রিফিউজড এরর তৈরি করে। যখন নিচের পরিকাঠামো শক্তিশালী হয়, এররের হার উল্লেখযোগ্যভাবে কমে যায় — কারণ সমস্যাগুলো লুকিয়ে ফেলা হয়েছে তা নয়, বরং এগুলো ঘনঘন ঘটে না।

"আপনার প্রক্সি পরিকাঠামোর গুণমান আপনার বেসলাইন এরর রেট নির্ধারণ করে। আপনি অ্যাপ্লিকেশন লেভেলে চিরকাল অপ্টিমাইজ করতে পারেন, কিন্তু নিম্নমানের প্রদানকারী সবসময় এমন নয়েজ তৈরি করবে যা আপনি নিয়ন্ত্রণ করতে পারবেন না।"

Nsocks ফিচারএরর প্রতিরোধের সুবিধা
স্থিতিশীল রাউটিং502 এবং 504 গেটওয়ে এরর হ্রাস করে
উচ্চ আপটাইম এসএলএপ্রক্সি সার্ভার ব্যর্থতার ঘটনা কমায়
নির্ভরযোগ্য অথেন্টিকেশনবারবার হওয়া 407 এবং 401 এরর প্রতিরোধ করে
ইউএস-ভিত্তিক পরিকাঠামোকম ল্যাটেন্সি, টাইমআউট সম্পর্কিত ব্যর্থতা কম
টেকনিক্যাল সাপোর্টসমস্যা দেখা দিলে দ্রুত সমাধান

মূল সুবিধা:

  • ✅ স্থিতিশীল রাউটিং — ধারাবাহিক পাথ বিরতিহীন ব্যর্থতা কমায়
  • ✅ উচ্চ আপটাইম — পরিকাঠামোর নির্ভরযোগ্যতা বেস এরর রেট কমায়
  • ✅ নির্ভরযোগ্য অথেন্টিকেশন — কোনো নিঃশব্দ টোকেন মেয়াদোত্তীর্ণ বা ক্রেডেনশিয়াল অমিল নেই
  • ✅ টেকনিক্যাল সাপোর্ট — কোনো সমস্যা হলে কাজের মধ্যে সহায়তা, শুধু ডকুমেন্টেশনে সীমাবদ্ধ নয়

সচরাচর জিজ্ঞাসিত প্রশ্নাবলী (FAQ)

প্রক্সি এরর 407 কী?

407 মানে আপনার রিকোয়েস্ট ফরোয়ার্ড করার আগে প্রক্সির নিজেরই অথেন্টিকেশন প্রয়োজন। এটি 401 এর চেয়ে আলাদা, যা অরিজিন সার্ভার থেকে আসে। এটি সমাধানের জন্য রিকোয়েস্ট হেডারে আপনার প্রক্সি ক্রেডেনশিয়াল যোগ করুন।

কেন 502 এরর ঘনঘন ঘটে?

ঘনঘন 502 এরর হওয়ার মানে সাধারণত এক বা একাধিক আপস্ট্রিম নোড অস্বাস্থ্যকর অথবা অবৈধ রেসপন্স ফেরত দিচ্ছে। লোড ব্যালেন্সার হেলথ চেক এবং আপস্ট্রিম সার্ভার লগ পরীক্ষা করুন। যদি এটি সময়ের সাথে সম্পর্কযুক্ত হয়, তবে ট্রাফিক স্পাইক এবং ক্ষমতার সীমা (capacity limits) দেখুন।

ল্যাটেন্সি কি 504 টাইমআউট ঘটাতে পারে?

হ্যাঁ, সরাসরি। 504 ঘটে যখন কনফিগার করা টাইমআউট সময় পর প্রক্সি আপস্ট্রিম রেসপন্সের জন্য অপেক্ষা করা বন্ধ করে দেয়। যদি আপস্ট্রিম ল্যাটেন্সি সেই থ্রেশহোল্ডের উপরে উঠে যায় — এমনকি সামান্য সময়ের জন্য হলেও — প্রক্সি একটি 504 ফেরত দেয়। টাইমআউট মান টিউন করা বা আপস্ট্রিম ল্যাটেন্সি কমানো উভয়ই সাহায্য করে।

কীভাবে আমি কনফিগারেশনের ভুল চিহ্নিত করব?

আপনার বর্তমান প্রক্সি সেটিংসকে একটি ভালো বেসলাইনের সাথে তুলনা করা শুরু করুন। পোর্ট নম্বর, প্রোটোকল ভার্সন, অথেন্টিকেশন স্কোপ এবং আইপি হোয়াইটলিস্ট এন্ট্রি পরীক্ষা করুন। প্রতিটি স্তর আলাদাভাবে পরীক্ষা করুন: আপনি কি সরাসরি আপস্ট্রিমে পৌঁছাতে পারছেন? প্রক্সি কি নিজের মতো আপনার ক্রেডেনশিয়াল গ্রহণ করছে?

কখন আমার সাপোর্টের সাথে যোগাযোগ করা উচিত?

সাপোর্টের সাথে তখন যোগাযোগ করুন যখন আপনি সঠিক কনফিগারেশন নিশ্চিত করেছেন, ক্রেডেনশিয়াল যাচাই করেছেন, সরাসরি এন্ডপয়েন্ট পরীক্ষা করেছেন এবং লগ পর্যালোচনা করেও স্পষ্ট কোনো কারণ খুঁজে পাননি। টাইমস্ট্যাম্প এবং আপনি যেসব পদক্ষেপ নিয়েছেন তা উল্লেখ করে লগের অংশ সংযুক্ত করুন — এটি দ্রুত সমাধানে সহায়তা করে।

2026-04-22