---
title: "API7 Enterprise的Canary流量切换策略实现精准流量控制 - API7.ai"
description: "了解API7 Enterprise如何赋能企业进行金丝雀流量切换，以实现高效的测试和性能优化。"
url: "https://api7.ai/ja/blog/api7-canary-traffic-shifting"
---

[Blog](https://api7.ai/ja/blog)

[Products](https://api7.ai/ja/category/products)[Technology](https://api7.ai/ja/category/technology)[Ecosystem](https://api7.ai/ja/category/ecosystem)[Case Study](https://api7.ai/ja/category/usercase)[Team & Community](https://api7.ai/ja/category/community)

Search

⌘ + K

[Blog](https://api7.ai/blog)

Products

# API7 Enterprise的Canary流量切换策略实现精准流量控制

January 29, 2024

[Products](https://api7.ai/category/products)

現代のマイクロサービスアーキテクチャにおいて、APIゲートウェイはシステムのトラフィックエントリとして機能し、リクエストのルーティング、認証、レートリミット、サーキットブレーカーなどの重要なタスクを処理します。[API7 Enterprise](https://api7.ai/enterprise)は、APISIXを基盤とした堅牢なAPI管理プラットフォームであり、ユーザーに豊富で柔軟な機能を提供します。その中でも、カナリアトラフィックシフトは、シームレスなサービスアップグレードや新機能の検証などのシナリオで重要な役割を果たします。

## 機能の概要

### アップストリームサービスに基づくアップストリームの作成

API7 Enterpriseのゲートウェイグループにサービスがデプロイされると、管理者は既存のベースラインアップストリームからカナリアトラフィックシフト用の新しいアップストリームを簡単に作成できます。このアップストリームは、ベースラインアップストリームのすべての設定を継承するか、テスト済みの過去の設定を選択的に継承することができます。この設計により、設定プロセスが大幅に簡素化され、繰り返し作業や設定ミスのリスクが低減されます。さらに、カナリアトラフィックシフト用のアップストリームは、新しいノードの設定やサービスディスカバリメカニズムの統合をサポートしています。これにより、既存のビジネスロジックに影響を与えることなく、一部のトラフィックを新しいサーバーや環境にリダイレクトして、パフォーマンステストや機能検証などの評価を行うことが可能です。

### 柔軟なシフト条件と重み付け

カナリアトラフィックシフト戦略を開始する際、管理者はシフト条件と重み付けを細かく定義できます：

**シフト条件**: どのトラフィックをカナリアトラフィックシフト用のアップストリームにリダイレクトするかを決定します。管理者は、論理演算子（「AND」や「OR」など）を使用して複数の条件を組み合わせ、特定の条件を満たすリクエストのみがカナリアトラフィックシフト環境に入るようにすることができます。

判断に使用できるプロパティは以下の通りです：

- **ヘッダー**: リクエストヘッダーの特定のフィールド（例: `User-Agent`）。

- **Cookie**: クライアントから送信されるCookie情報（ユーザー識別やセッション状態の認識に使用）。

- **クエリパラメータ**: URLのクエリ文字列パラメータ。

- **変数**: システムまたはカスタム変数（地理的位置やユーザーロールなど）。

  マッチングロジックには、等しい（==）、等しくない（\~=）、正規表現マッチング（\~\~）などがあり、条件判断の柔軟性と精度を確保します。

  例えば、管理者は次のシフト条件を設定できます：「リクエストヘッダーの`User-Agent`フィールドに'iPhone'が含まれ、かつCookieの`user_group`フィールドが'test\_group'に等しい場合、リクエストをトラフィックシフト用のアップストリームにリダイレクトする。」

**シフト重み**: カナリアトラフィックシフト用のアップストリームにリダイレクトするトラフィックの割合を決定します。これはパーセンテージ値であり、管理者はカナリアトラフィックシフト環境に入るトラフィックを徐々に増減させることができます。

初期段階では、重みを低い値（例: 10%）に設定し、新機能を小範囲でテストすることができます。テストが進み、結果が収集されるにつれて、重みを徐々に増やし、最終的には100%のトラフィックを新バージョンに切り替えることができます。

シフト条件と重みを柔軟に調整することで、管理者はカナリアトラフィックシフトテストの範囲と影響を効果的に制御し、新機能のスムーズな展開とシステムの安定性を確保できます。

![API7 Enterpriseのトラフィックシフト](https://static.api7.ai/uploads/2024/01/29/Mm2x59Vk_canary-release.png?imageMogr2/format/webp)

## 実用的なアプリケーションシナリオ

1. **新機能の検証**: 開発チームが新機能を完成させ、リリース準備が整った際、カナリアトラフィックシフトを使用して、新機能を一部のユーザーや特定のユーザーグループに初期展開できます。これにより、実際の環境でユーザーフィードバックを収集しながら、問題が発生した場合の影響範囲を管理できます。
2. **パフォーマンステスト**: 大規模なイベントや高負荷シナリオにおいて、管理者はカナリアトラフィックシフトを使用して、一部のトラフィックを新しく設定された高容量ノードにリダイレクトし、システムのパフォーマンス限界と安定性をテストできます。
3. **段階的な移行**: サービスのアップグレードや移行中、カナリアトラフィックシフトを使用して、管理者は古い環境から新しい環境へのトラフィックを段階的に移行し、スムーズな移行プロセスを確保できます。

## ベストプラクティス

1. **適切なシフト条件の設定**: 実際のニーズに基づいて適切なシフト条件を選択することが重要です。例えば、特定のユーザーグループを対象としたテストでは、Cookieやヘッダーのユーザー識別子を使用して、正確なシフトを実現できます。
2. **重みの動的調整**: テスト中に、テスト結果やユーザーフィードバックに基づいてシフト重みを動的に調整することで、有効なデータの収集を加速したり、問題の範囲を狭めたりできます。
3. **監視とアラート**: トラフィックシフト中に関連するメトリクスの監視を強化し、適切なアラートメカニズムを設定することで、問題を迅速に検出し、解決できます。

## 結論

[API7 Enterprise](https://docs.api7.ai/enterprise/introduction)のカナリアトラフィックシフトを通じて、企業はサービスの安定性を確保するだけでなく、新機能のテストやパフォーマンス最適化などの操作を柔軟に行うことができ、ビジネスの急速な成長を強力にサポートします。

Tags:

[Traffic Management](https://api7.ai/tags/traffic-management)

Share article link

Share

Related Posts

[![Apache APISIX Ingress Controller 中的流量分割](https://static.api7.ai/uploads/2024/09/06/4ZG5lbPP_Traffic%20Split.png)](https://api7.ai/blog/traffic-split-in-apache-apisix-ingress-controller)

## [Apache APISIX Ingress Controller 中的流量分割](https://api7.ai/blog/traffic-split-in-apache-apisix-ingress-controller)

[![API7 Enterprise v3.5.0：マルチアップストリーム構成](https://static.api7.ai/uploads/2025/02/19/mQ8cStKu_multi-upstream-configuration.png)](https://api7.ai/blog/api7-3.5.0-mutli-upstream-for-traffic-management)

## [API7 Enterprise v3.5.0：マルチアップストリーム構成](https://api7.ai/blog/api7-3.5.0-mutli-upstream-for-traffic-management)

Table of Contents

- [機能の概要](#%E6%A9%9F%E8%83%BD%E3%81%AE%E6%A6%82%E8%A6%81)

  - [アップストリームサービスに基づくアップストリームの作成](#%E3%82%A2%E3%83%83%E3%83%97%E3%82%B9%E3%83%88%E3%83%AA%E3%83%BC%E3%83%A0%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%81%AB%E5%9F%BA%E3%81%A5%E3%81%8F%E3%82%A2%E3%83%83%E3%83%97%E3%82%B9%E3%83%88%E3%83%AA%E3%83%BC%E3%83%A0%E3%81%AE%E4%BD%9C%E6%88%90)
  - [柔軟なシフト条件と重み付け](#%E6%9F%94%E8%BB%9F%E3%81%AA%E3%82%B7%E3%83%95%E3%83%88%E6%9D%A1%E4%BB%B6%E3%81%A8%E9%87%8D%E3%81%BF%E4%BB%98%E3%81%91)

- [実用的なアプリケーションシナリオ](#%E5%AE%9F%E7%94%A8%E7%9A%84%E3%81%AA%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%B7%E3%83%8A%E3%83%AA%E3%82%AA)

- [ベストプラクティス](#%E3%83%99%E3%82%B9%E3%83%88%E3%83%97%E3%83%A9%E3%82%AF%E3%83%86%E3%82%A3%E3%82%B9)

- [結論](#%E7%B5%90%E8%AB%96)

## Related Posts

[![API7 Enterprise 3.0 系列：通过可持续生态系统加速业务增长](https://static.api7.ai/uploads/2024/01/23/RXTQoan0_enterprise3.0.png)](https://api7.ai/ja/blog/api7-enterprise-3.0)

Products

August 31, 2023

#### [API7 Enterprise 3.0 系列：通过可持续生态系统加速业务增长](https://api7.ai/ja/blog/api7-enterprise-3.0)

API7 Enterprise 3.0の力を解き放ちましょう！GraphQLプラグインのサポート、シームレスなSOAP統合、トラフィックラベリング、ゲートウェイグループリリース、宣言型API、そして強化されたトークン管理を体験してください。

[API7 Enterprise](https://api7.ai/tags/api7-enterprise)

[SOAP](https://api7.ai/tags/soap)

[Traffic Management](https://api7.ai/tags/traffic-management)

[![API7 Enterprise通过流量标签简化API流量管理](https://static.api7.ai/uploads/2024/12/25/DEIRFiDW_api7-traffic-labeling.png)](https://api7.ai/ja/blog/api7-enterprise-traffic-labeling)

Products

June 14, 2023

#### [API7 Enterprise通过流量标签简化API流量管理](https://api7.ai/ja/blog/api7-enterprise-traffic-labeling)

API7 Enterpriseは、新しいプラグイン「traffic-label」をサポートしており、より柔軟で正確なトラフィック制御を可能にします。

[API7 Enterprise](https://api7.ai/tags/api7-enterprise)

[API Gateway Concepts](https://api7.ai/tags/api-gateway-concepts)

[Traffic Management](https://api7.ai/tags/traffic-management)

[![Apache APISIX 通过 Service Mesh 实现全流量管理的统一](https://static.api7.ai/uploads/2024/09/06/9D7kJMeJ_Service%20Mesh.png)](https://api7.ai/ja/blog/apisix-unifies-traffic-management-with-service-mesh)

Products

October 28, 2022

#### [Apache APISIX 通过 Service Mesh 实现全流量管理的统一](https://api7.ai/ja/blog/apisix-unifies-traffic-management-with-service-mesh)

本文介绍了Apache APISIX如何通过基于APISIX的Service Mesh解决方案，统一全流量管理与Service Mesh。

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Traffic Management](https://api7.ai/tags/traffic-management)

[Service Mesh](https://api7.ai/tags/service-mesh)
