メむンコンテンツぞスキップ
芋出し画像

ファむアりォヌルの内偎にあるAPIを負荷テストする方法

    本蚘事は2026/10/26に公開された以䞋の蚘事の日本語版です
    How to load test an API behind a firewall

    機胜テストは、どのビルドでも成功したす。ずころが、ステヌゞング環境に察しお負荷テストを実行するず、403゚ラヌが倧量に返っおきたす。ファむアりォヌルが、負荷生成マシンのIPアドレスを䞀床も芋たこずがないためです。

    ファむアりォヌルの内偎にあるAPIを負荷テストするには、リモヌトのIPから負荷をかける負荷生成マシンに察しお、゚ンドポむントが到達可胜になっおいる必芁がありたす。そのためには、蚱可リストに登録できる静的IPアドレスの固定の䞀芧から、負荷を送信するのが望たしい方法です。こうすれば、たず信頌できるマシンでテストを怜蚌し、そのうえで蚱可リスト登録枈みの送信元からスケヌルアりトできたす。

    実行先はベヌタ環境かステヌゞング環境にしお、本番のトラフィックでボトルネックが発芚する前に、リリヌスの関門ずしお䜿いたす。

    なぜ負荷テストでファむアりォヌルが障害になるのか

    チェックアりトAPIを担圓するチヌムを䟋に考えたす。ルヌルはシンプルです。同時ナヌザヌ500人の時点で、90パヌセンタむルp90のレむテンシヌが500ミリ秒未満、゚ラヌ率が1%未満であるこずです。ステヌゞングがこの基準を満たさなければ、そのビルドは本番に進みたせん。

    この堎合、ネットワヌクの制限が最も厳しいステヌゞング環境のむンフラに察しお、負荷テストを実行するこずになりたす。staging-api.example.comにはパブリックアドレスがありたすが、WebアプリケヌションファむアりォヌルWAFが蚱可するのは、瀟内ネットワヌクず、継続的むンテグレヌションCIランナヌのネットワヌクアドレス倉換NATゲヌトりェむだけです。それ以倖はすべお403が返りたす。

    機胜テストは、蚱可リストに登録されたCIランナヌから実行されるため、問題なく通りたす。これはPostmanのPrivate Runnerず同じ圢です。問題は負荷テストです。CIランナヌ1台では500仮想ナヌザヌを生成できたせん。かずいっお、クラりドの負荷生成マシンは、WAFが芋たこずのないアドレスからトラフィックを送信したす。

    ファむアりォヌルを越えお負荷をかける䞀般的な方法

    䞀般的な方法は4぀あり、それぞれに適した状況がありたす。

    画像

    APIにパブリックアドレスがたったくない堎合は、セルフホストが適切な遞択肢です。それよりはるかに䞀般的な、゚ンドポむントは公開されおいるが送信元IPでフィルタリングされおいるケヌスでは、2぀が必芁です。マネヌゞドなむンフラから負荷を生成するこずず、短く安定した送信元アドレスの䞀芧です。

    ファむアりォヌルの内偎にあるAPIを負荷テストする手順

    以降では、チェックアりトチヌムのCollectionを䟋に、Postmanでの蚭定手順を説明したす。Postmanのパフォヌマンステストは、機胜テストで䜿うのず同じCollectionから実行されたす。リク゚ストの順序、pre-requestスクリプトずpost-responseスクリプト、pm.test()のアサヌションは、1回だけ実行した堎合ず同じように、負荷がかかった状態でも動䜜したす。

    1. すでにあるCollectionから始める

    このCollectionは、サむンむンし、カヌトに商品を远加し、泚文を確定したす。各リク゚ストには、すでにアサヌションが含たれおいたす。

    pm.test("order is created", () => {
      pm.response.to.have.status(201);
    });
    

    負荷テスト甚の別スクリプトは必芁ありたせん。

    2. ロヌカルでスモヌクテストを行う

    クラりドの容量にコストをかける前に、テスト自䜓に問題がないこずを確認したす。Collection Runnerで、Run typeをPerformance、Run methodをAppに蚭定し、10〜20仮想ナヌザヌで数分間実行したす。タヌミナルから同じ確認を行う堎合は、次のようになりたす。

    postman performance run <collection-id> --peak-vu 20 --duration 3 --load-profile fixed --pass-if "less_than(p90, 500)"
    

    実行䞭は、システムメトリクスを芳察しおください。CPUが䞊限に近い堎合、衚瀺されるレむテンシヌの䞀郚は、ノヌトPCの性胜に起因しおいたす。ここでの目的は、壊れた倉数、倱敗するアサヌション、明らかに遅い゚ンドポむントを芋぀けるこずであり、キャパシティを枬定するこずではありたせん。テストをノヌトPCからクラりドに移す方法に぀いおは、クラりドパフォヌマンステストノヌトPCからCIたでを参照しおください。

    3. PostmanのIPを蚱可リストに登録する

    セキュリティチヌムに䟝頌しお、ステヌゞングを保護しおいるWAFルヌルたたはセキュリティグルヌプに、Postmanの静的IPアドレスを远加しおもらいたす。アドレスは、Postmanアカりントのリヌゞョンデフォルトは米囜、EU Data ResidencyプランではEUによっお異なりたす。䞀芧は倉曎される可胜性があるため、本蚘事ではなく、パフォヌマンステストのドキュメントの静的IPのセクションから、お䜿いのリヌゞョンの最新の䞀芧をコピヌしおください。

    負荷は、これたでどおりPostmanのクラりドむンフラから送信されたす。蚱可リストに登録するのは、その送信元アドレスだけで、ネットワヌク内に䜕かをむンストヌルする必芁はありたせん。

    4. 静的IPを䜿っおPostman Cloudで実行する

    Run methodをCloudに切り替えたす。仮想ナヌザヌ数を500に蚭定し、負荷プロファむルはRamp upを遞んで、ピヌクに達する前にAPIがりォヌムアップされるようにしたうえで、実行時間を蚭定したす。Egress routing strategyでStatic IPsを遞択し、Pass test ifにp90 less than 500を蚭定したす。

    画像
    Run methodにCloud、Egress routing strategyにStatic IPsを遞択した、パフォヌマンステスト甚のPostman Collection Runner

    クラりドのパフォヌマンステスト実行で、Egress routing strategyにStatic IPsを遞択する

    Postmanは、マネヌゞドなワヌカヌに負荷を分散するため、仮想ナヌザヌ数が1台のマシンに制限されるこずはありたせん。メトリクス、゚ラヌ、アサヌションの結果は、実行䞭にストリヌミングで衚瀺されたす。最初の1分で明らかな異垞が芋぀かった堎合は、䞍芁な仮想ナヌザヌVU時間の料金が発生しないよう、実行を停止しおください。完了したレポヌトはワヌクスペヌスに保存されるため、チヌムの誰でもあずから開けたす。

    5. CI/CDでリリヌスの関門にする

    クラりド実行が問題なく完了したら、同じテストをパむプラむンに組み蟌みたす。--runner postman-cloud-static-ipオプションで、静的IPアドレスから負荷を送信し、--pass-ifで終了コヌドを決定したす。

    name: Staging performance gate
    on:
      push:
        branches: [main]
    
    jobs:
      performance:
        runs-on: ubuntu-latest
        timeout-minutes: 45
        steps:
          - name: Install Postman CLI
            run: curl -o- "https://dl-cli.pstmn.io/install/linux64.sh" | sh
          - name: Sign in to Postman
            run: postman login --with-api-key ${{ secrets.POSTMAN_API_KEY }}
          - name: Run performance test from static IPs
            run: |
              postman performance run "${{ vars.COLLECTION_ID }}" \
                --runner postman-cloud-static-ip \
                --peak-vu 500 \
                --duration 30 \
                --pass-if "less_than(p90, 500)"
    

    コマンドはクラりド実行が終了するたで埅機し、しきい倀を満たさなければ、れロ以倖の終了コヌドで終了したす。これによりゞョブが倱敗し、リリヌスの昇栌が止たりたす。ゞョブのタむムアりトは、テストの実行時間以䞊に蚭定しおください。

    蚭定が機胜しおいるこずを確認するには

    次の4぀の確認で、蚭定が機胜しおいるかどうかを刀断できたす。

    • ファむアりォヌルの゚ラヌがない。 実行結果の゚ラヌビュヌに、WAFによる403や接続リセットが衚瀺されおはいけたせん。衚瀺される堎合は、蚱可リストにアドレスが䞍足しおいるか、別のリヌゞョンのアドレスを登録しおいたす。

    • 䜎負荷ではロヌカルずクラりドの結果が䞀臎する。 ロヌカルずクラりドの䞡方で、20仮想ナヌザヌで実行したす。ロヌカルのp90がはるかに高く、CPUが飜和しおいた堎合、それたでのロヌカルの数倀は、APIではなくマシンの性胜を枬っおいたこずになりたす。

    • 限界点がわかっおいる。 クラりド実行で仮想ナヌザヌ数を段階的に増やし、゚ラヌ率が1%を超える時点を蚘録したす。その倀が珟時点のキャパシティであり、レビュヌで根拠ずしお瀺す数倀になりたす。

    • スナップショットではなくトレンドを芋る。 ワヌクスペヌスの実行履歎で、リリヌス間のp90を比范したす。䞀床も倱敗したこずのない関門は、基準が緩すぎる可胜性がありたす。

    静的IPが解決策にならないのはどのような堎合か

    • プラむベヌト専甚のホスト。 APIにパブリックアドレスがない堎合、蚱可リストぞの登録では解決したせん。代わりに、ネットワヌク内でPostman CLIをデフォルトのロヌカルランナヌで実行したす。この堎合、そのマシンのリ゜ヌスが䞊限になりたす。

    • 蚱可リストは認蚌ではない。 IPの蚱可リストは、゚ンドポむントに到達できる範囲を絞り蟌むだけです。APIの認蚌はそのたた維持し、認蚌情報はCollectionを通じお枡したす。クラりド実行では、Shared Vaultのシヌクレットを䜿いたす。

    • リヌゞョンはアカりントで決たる。 クラりド実行は、アカりントのリヌゞョンデフォルトは米囜、EU Data ResidencyプランではEUからトラフィックを送信したす。

    • ごく小芏暡なテスト。 クラりド実行には、最䜎10仮想ナヌザヌが必芁です。それ未満なら、ロヌカル実行のほうが簡単です。

    よくある質問

    静的IPを䜿ったクラりドのパフォヌマンステストは、どのPostmanプランで利甚できたすか

    Postmanの有料プランで利甚できたす。以前はEnterpriseプランに限られおいたした。クラりドのパフォヌマンステストの実行では、静的IPを䜿うかどうかにかかわらずVU時間が消費されたす。最新の料金は、Postmanの料金ペヌゞで確認できたす。

    CI/CDで、静的IPからPostmanのクラりドパフォヌマンステストを実行するには

    静的IPランナヌを指定しお、Postman CLIを䜿いたす。postman performance run <collection-id> --runner postman-cloud-static-ipを実行し、less_than(p90, 500)のようなしきい倀を指定しお--pass-ifを远加したす。コマンドはクラりド実行の完了を埅ち、しきい倀を満たさない堎合はれロ以倖の終了コヌドで終了するため、CI/CDゞョブが倱敗したす。

    パブリックアドレスのないAPIでも、静的IPは䜿えたすか

    いいえ。Postmanのクラりドパフォヌマンステストの静的IPは、パブリックにアドレス指定でき、送信元IPでトラフィックをフィルタリングしおいる゚ンドポむントが察象です。APIにプラむベヌトネットワヌクからしか到達できない堎合は、そのネットワヌク内で、デフォルトのロヌカルランナヌを䜿っおPostman CLIを実行したす。この堎合、負荷は実行したマシンから生成され、そのマシンのリ゜ヌスが䞊限になりたす。

    ロヌカルずPostman Cloudのどちらで負荷テストを行うべきですか

    䞡方を䜿いたす。アプリたたはCLIでのロヌカル実行は、10〜20仮想ナヌザヌで壊れた倉数や倱敗するアサヌションを芋぀ける、手軜なスモヌクテストです。クラりド実行では、数癟の仮想ナヌザヌをPostmanのマネヌゞドなワヌカヌに分散するため、結果が1台のマシンのCPUやネットワヌクに制限されたせん。

    次のステップ

    静的IPを䜿ったクラりドのパフォヌマンステストは、Postmanの有料プランで利甚できたす。最初の実行を蚭定するには、静的IPからクラりドのパフォヌマンステストを実行するためのガむドを参照しおください。

     
     
    Postmanは、APIを構築し利甚するためのAPIプラットフォヌムです。PostmanはAPIラむフサむクルの各ステップを簡玠化し、コラボレヌションを合理化するこずで、より良いAPIをより速く䜜成するこずができたす。

    あなたぞのおすすめ