# セッション制限到達アラート

セッション制限到達アラートは、現在のEMQXクライアント接続数がデプロイメントの閾値を超えたことを示します。

この状態は、デプロイメントが想定される接続容量に近づいており、新規接続や全体のパフォーマンスに影響を及ぼす可能性があることを意味します。主な原因としては、急激な接続数の増加、接続が速やかに解放されないこと、同一デバイスからの複数クライアントセッションがあります。

## クライアント接続の急激な増加

### 症状

EMQXが短期間に多数の新規接続を受け付けます。デプロイメントの**モニター**ページでは、接続数が急激に上昇し、ビジネストラフィックのピークに対応しています。

### 主な原因

バッチ展開後、システム再起動、またはデバイスの電源オンイベント後に多くのクライアントが一斉にオンラインになる、あるいはビジネスピークが計画された接続容量を超える場合です。

### 対応策

**モニター** -> **メトリクス** -> **タイムライン** -> **接続数** に移動し、接続数の推移を確認します。ピーク時の接続需要を事前に見積もり、トラフィックがピークに達する前にデプロイメントをスケールアウトしてください。

![モニターのタイムラインにおける接続数](./_assets/session_limit_monitor.png)

## 接続が速やかに解放されない

### 症状

接続数が予想より高いままで、切断された接続数が異常に多い状態です。

### 主な原因

一部のクライアントが接続を閉じずに異常終了したり、長いキープアライブ設定により非アクティブな接続がシステムに残ることがあります。これらの接続は容量を消費し続けます。

### 対応策

- キープアライブ間隔を短くして、異常な接続を早期に検知・削除できるようにします。
- 長期間トラフィックがないアイドル状態のクライアントを定期的に切断します。

## 1台のデバイスからの複数クライアントセッション

### 症状

接続数が予期せず増加し、クライアントセッション数がオンラインデバイス数を大幅に上回っています。

### 主な原因

クライアントが `Clean Session = False` を使用しつつ、SDKがランダムなClient IDを生成している場合です。頻繁な再接続により、1台のデバイスに対して数百または数千のオフラインセッションが作成され、接続リソースを消費し、間接的に接続数を増加させます。

### 対応策

ランダムなClient IDと `Clean Session = False` を組み合わせないでください。再接続のたびに新しいセッションが作成されるためです。

## トラブルシューティング

1. EMQX Cloudコンソールにログインし、デプロイメントの**モニター** -> **メトリクス**に移動します。

   - 過去30分間の最大接続数がデプロイメントの最大接続制限を超えた場合にアラートが発生します。
   - 過去30分間の最大接続数が制限の110％を超えると、新規クライアント接続が拒否されます。**デプロイメントログ**を開き、**エラータイプ**を**Clients**に設定して、以下のようなエントリを探してください。

     ```text
     peername: xx.xxx.xxx.xx:64599, pid: <xxxxx>, tag: LICENSE, msg: connection_rejected_due_to_license_limit_reached
     ```

2. **モニター** -> **クライアント**に移動し、切断されたクライアントをフィルターします。同じIPアドレスで異なるClient IDを持ち、`Clean Session = False` を使用しているクライアントが複数いる場合、1台のデバイスが複数のセッションを作成している可能性があります。

   ![切断されたクライアントセッション](./_assets/session_limit_clients.png)

## 最大接続制限の引き上げ

> このセクションは、デプロイメントの接続制限を引き上げた場合の挙動と影響について説明しています。アラートの直接的なトラブルシューティング手順ではありません。

最大接続制限を引き上げるには、EMQX Cloudにチケットを提出して自動スケーリングを依頼してください。オペレーションチームが環境を準備した後、スケーリングは通常15～25分で完了します。

スケーリング中もサービスは利用可能ですが、デバイスは数秒間の短い切断後に2～3回再接続することがあります。クライアントが自動再接続を実装している場合、通常は業務に目立った影響はありません。
