# 設定とトラブルシューティング Qlik Data Gateway - 直接アクセス

このトピックでは、Direct Access gateway の設定とトラブルシューティングで実行できるさまざまなアクションについて説明します。

情報メモこのトピックで説明するすべての構成オプションは、Direct Access gateway パブリック API からも実行できます。詳細については、https://qlik.dev/apis/rest/direct-access-agents/ を参照してください。

## Qlik Cloud テナントから Direct Access gateway を構成する

Direct Access gateway の既定の設定はほとんどの環境に適していますが、パフォーマンスの向上、問題のトラブルシューティング (ログ設定を使用) 、またはさまざまな接続性の問題の克服のために、既定の設定のオーバーライドが必要になることがあります。

情報メモ

* Qlik Cloud からの Direct Access gateway の構成は 1.7.2 以降でサポートされていますが、構成オプションの完全なセットを活用するには最新バージョンにアップグレードすることをお勧めします。

* ほとんどの Direct Access gateway 設定は Qlik Cloud 管理 アクティビティ センターで構成できますが、一部の設定は [Direct Access gateway マシンで直接](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Configur2)構成ファイルを編集することによってのみ変更できます

Qlik Cloud の設定を編集するには、次のいずれかの権限が必要です。

* テナント管理者およびゲートウェイ スペース所有者

* ゲートウェイ スペースで [データ消費可能] 権限を持つテナントメンバー

ゲートウェイ設定を開くには、次を実行します。

1. Qlik Cloud テナントで、管理 > [データ ゲートウェイ] に移動し、Direct Access gateway を見つけます。

2. 行の最後で the 詳細 icon をクリックし、[ゲートウェイ設定] を選択します。

   [ <名前> のゲートウェイ設定] ダイアログが開きます。

   設定は、一般設定 (以下) と [コネクタ設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Connecto)に分かれています。設定を変更すると、[Direct Access gateway サービスの再起動](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Restarti)も必要になる場合があることに注意してください。

### 一般設定

これらの設定は、使用しているコネクタに関係なく、Direct Access gateway の一般的な機能に関連します。

#### エージェント ID

Direct Access gateway パブリック API で使用するエージェント ID。

#### コネクタ エージェントのポート

コネクタ エージェントに接続するときに使用するポート。この設定は変更できません。

#### コネクタ エージェントのヘルス障害しきい値

Direct Access gateway のコンポーネントには、定期的なヘルス チェックが行われます。ヘルス チェックは、最初は失敗し、その後に成功することがあります。指定されたしきい値を超えてもヘルス チェックが失敗し続ける場合は、Direct Access gateway サービスが再起動します。この設定は、[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)から要求された場合にのみ変更してください。

#### ロード リクエストタイムアウト

ネットワークの中断が発生すると、次のエラーでリロードが失敗する可能性があります。

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

上記のエラーが頻繁に発生する場合は、タイムアウトを 5 ～ 10 分に延長してみてください。

#### コネクタ エージェントのロギング レベル

トラブルシューティングの目的で、コネクタ エージェント コンポーネントのログ レベルを変更する必要がある場合があります。この設定は、[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)から要求された場合にのみ変更してください。

#### コネクタ エージェントのロギング オプション

特定のコネクタ エージェント コンポーネントに関する問題をトラブルシューティングするには、対応するログ ファイルを選択する必要がある場合があります。この設定は、[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)から要求された場合にのみ変更してください。

#### コネクタ エージェントのログ ファイル サイズの上限

新しいファイルに切り替わる前に、コネクタ エージェントのログ ファイルの最大サイズ (MB) を設定します。

#### コネクタ エージェント ファイルの保持期間の上限

コネクタ エージェントのログ ファイルが自動的に削除されるまでの保持日数を設定します。

#### キャッシュ データ チャンク用メモリ

各リロード操作について、Direct Access gateway はデータチャンクをメモリにキャッシュし、それらをディスクにオフロードできます (キャッシュに割り当てられたサイズを超えた場合)。これは、自動回復を使用せず、4025、4020、4021 エラーが頻繁に発生する場合に特に役立ちます。指定されたしきい値に達すると、ゲートウェイは次の暗号化されたチャンクを Direct Access gateway マシンのディスクにオフロードします。0 (デフォルト) の値はチャンク回復を無効にします。

#### チャンク回復時間のしきい値

これは、チャンク回復期間のしきい値 (分単位) です。回復期間のしきい値に達した時点でリロードが再開されない場合、適切なメッセージが表示されて失敗します。

このオプションは、長時間の回復後に、3 時間の制限を超える可能性があるリロードに役立ちます。たとえば、データベースからデータを取得するのに 90 分かかり、リロードが開始されるとすぐにチャンクの 1 つが破損したとします。この場合、すべてのチャンクがキャッシュに保存され、キャッシュから送信されます。このようなシナリオでは、リロード プロセス全体 (キャッシュへの保存と実際のリロード) が完了するまでに 3 時間かかる可能性があります。

#### 既定のキャッシュ ディレクトリをオーバーライド

新しいキャッシュ ディレクトリを設定します。

#### DCaaS ポート

DCaaS に接続するときに使用するポート。この設定は変更できません。

#### DCaaS ロギング レベル

トラブルシューティングの目的で、DCaaS ログのログ レベルを変更する必要がある場合があります。この設定は、[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)から要求された場合にのみ変更してください。

#### DCaaS ログ ファイルの保持期間の上限 (日数)

Qlik Data Gateway - 直接アクセス がコンポーネントのログ ファイル (コネクタ、DCaaS、エージェントなど) を保持する日数を制限できます。指定した日数より古いログ ファイルは自動的に削除されます。

#### データ ポート範囲の開始

プロセス分離のデータ ポート範囲の開始を設定します。

#### 負荷パフォーマンスのメトリクス

これらの構成プロパティは、負荷パフォーマンス結果に関連しています。このプロパティは、ゲートウェイ マシンに保持されるデータの量と、時間の経過に伴うデータのクリーンアップ方法を制御します。

情報メモDirect Access gateway 1.7.17 以降でサポートされています。

* 負荷パフォーマンス メトリクスのレコードを有効化: 負荷パフォーマンス メトリクスを永続化するかどうかを選択します。

* ベンチマーク保持クリーンアップを有効化: ベンチマーク レコードを自動的にクリーン アップするかどうかを選択します。

* ベンチマーク保持: クリーンアップまでにベンチマーク レコードを保持する日数を設定します。

* ベンチマーク保持チェック間隔: クリーンアップ可能なベンチマーク レコードをチェックする間隔を設定します。

* ベンチマーク保持データベース サイズ: ベンチマーク レコードのターゲット データベース サイズ (MB) を設定します。

* ベンチマーク保持クリーンアップのバッチ サイズ: クリーンアップ バッチごとに削除するベンチマーク レコード数を設定します。

### コネクタ設定

コネクタ設定を変更するには、左側でコネクタ タイプを選択し、必要に応じて以下の設定を変更します。

#### ポート

データ ソースへの接続時に使用するポート。この設定は変更できません。

#### ロギング レベル

トラブルシューティングの目的で、コネクタ ログのロギング レベルを変更する必要がある場合があります。この設定は、[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)から要求された場合にのみ変更してください。

#### プロセス分離

情報メモ

Direct Access gateway 1.6.1 以降が必要です。

プロセス分離により、Direct Access gateway サーバー オペレーティング システムにアクセスできる管理者は、コネクタ タイプごとにリロードおよび/またはメタデータ コマンドに使用できるプロセスの数を制御できます。リロードおよび/またはメタデータ コマンドを複数のコネクタ プロセスに分散すると、各コネクタ プロセスで同時に実行されるリロードの数が減り、分離レベルが高まります。これにより、コネクタのクラッシュが発生した場合の Direct Access gateway 全体の安定性が向上します。

クリーン インストールでは、プロセス分離は既定で有効になっています。各コネクタ タイプにおける、同時リロードまたはメタデータ コマンドのデフォルト数は 9 です。以下の同時リロード/コマンド プロセス数で説明されているように、デフォルト設定を上書きできます。

オプションは次のとおりです。

* 無効: Qlik サポートでは、トラブルシューティングの目的でプロセス分離を無効にするように依頼する場合があります。

* メタデータ: メタデータ コマンドに対してのみプロセス分離を有効にします。これは、マルチスレッドをサポートしない ODBC ドライバーを使用しているが、メタデータ コマンドを並行して実行したい場合 (主にプレビュー目的で) などに便利です。

  情報メモDirect Access gateway 1.7.9 以降でサポートされています。

* リロード (デフォルト): リロード コマンドに対してのみプロセス分離を有効にします。

* すべて: リロード コマンドとメタデータ コマンドの両方に対してプロセス分離を有効にします。

  情報メモDirect Access gateway 1.7.9 以降でサポートされています。

#### 同時リロード/コマンド プロセス数

コマンド プロセスを含む、コネクタに割り当てられた同時リロード/コマンド プロセスの数。したがって、たとえば値が 30 の場合、同時リロード/コマンドの最大数は 29 になります。この設定は、プロセス分離が有効になっている場合にのみ関連します。

情報メモDirect Access gateway バージョン 1.6.7 以降では、この値は、他の設定を変更することなく 10 を超えることが可能になりました。特定のコネクタ タイプでのリロードを完全に分離するには (つまり、コネクタ プロセスごとにリロードが 1 回だけになるようにするには)、この値を最小 30 に設定する必要がありますが、ワークロードによっては 60 まで設定する必要がある場合があります。

#### リロード セッション時間

情報メモODBC (Direct Access gateway 経由) コネクタにのみ関連します。

Direct Access gateway と Qlik Cloud の間の接続が 20 秒以上アイドル状態である場合、リロード操作が次のエラーで失敗することがあります。

Invalid object name '#<TempTableName>' (indicating that the Direct Access gateway temp tables are unavailable).

既定のセッション時間は 20 秒ですが、このエラーが頻繁に発生する場合は、必要に応じてセッション時間を延長できます。

#### アンロードするテーブルの最大数

情報メモ

* ODBC (Direct Access gateway 経由) コネクタにのみ関連します。

* Direct Access gateway 1.7.1 以降が必要です。

既定では、データベースから最大 10,000 個のテーブルが取得されます。データベースのテーブル数が 10,000 を超える場合は、既定をオーバーライドできます。

#### 詳細なエラー メッセージを表示

情報メモ

* ODBC ベースのコネクタにのみ関連します。

* UI で表示するには、Direct Access gateway 1.7.11 以降が必要です。

セキュリティ上の懸念から、ODBC ドライバーによって返される既定のエラー メッセージには最小限の情報しか含まれていません。ただし、特定のシナリオでは、特定の問題をトラブルシューティングするために、さらなる情報が必要になる場合があります。より詳細なエラー メッセージを生成するには、このオプションを有効にします。問題が解決したら、セキュリティを最適化するために、このオプションを無効にすることを強くお勧めします。

#### Direct Access gateway が REST コネクタを使用してアクセスできる URL を制限する

REST コネクタでアクセスできる特定の URL または URL パスへのアクセスを制限できます。

情報メモURL への変更 (追加、編集、削除) は、Direct Access gateway サービスを再起動した後にのみ有効になります。

特定の URL へのアクセスを制限するには、 [許可された URL] フィールドに URL を入力し、 [追加] をクリックします。URL パスへのアクセスを制限する場合も同様に操作しますが、URL の末尾にアスタリスク (\*) を付けます。必要に応じて繰り返します。

例

次の例では、 [許可された URL] リストに 2 つのエントリが含まれています。

* 最初のエントリでは、`https://mypublicrestservice.com/restricted/source` へのアクセスのみが許可されます。

* 2 番目のエントリでは、`https://mypublicrestservice.com/open` およびその下のパス (`https://mypublicrestservice.com/open/shared` など) へのアクセスが許可されます。

| 許可された URL |
| --- |
| `https://mypublicrestservice.com/restricted/source` |
| `https://mypublicrestservice.com/open`\* |

URL の編集または削除

URL を編集するには、行の末尾にある the Edit Outline icon ボタンをクリックし、必要に応じて URL を編集します。変更を保存するには the Tick icon を、キャンセルするには the Cross icon をクリックします。

URL を削除するには、行の末尾にある the Bin Outline icon ボタンをクリックします。

関連記事: [REST 接続の作成](https://help.qlik.com/en-US/cloud-services/Subsystems/REST_Connector_help/Content/Connectors_REST/Create-REST-connection/Create-REST-connection.htm) (英語のみ)。

#### Direct Access gateway がファイル コネクタを使用してアクセスできるパスのリストを制限する

ファイル コネクタを使用してアクセスできるパスへのアクセスを制限できます。パスを 1 つ以上のスペースとペアにして、指定したパスへのアクセスをさらに制限することもできます。

情報メモ

* ペアリングされたスペースは、Direct Access gateway 1.7.6 以降でサポートされています。

* Direct Access gateway 1.7.4 または 1.7.5 を使用している場合、パスまたはスペースの追加、編集、削除などの変更は、Direct Access gateway サービスを再起動した後にのみ有効になります。

* データ消費可能ロール以上のユーザー (編集可能、アプリケーションでデータ編集可能、管理可能) のみが、パスにアクセスできます。

* 標準の DOS パスと UNC パスを含む、すべての Windows ファイルシステムとネットワークドライブがサポートされています。

特定のパスへのアクセスを制限するには、 [ファイル パス] フィールドにパスを入力し、 [追加] をクリックします。必要に応じて繰り返します。

スペースとパスをペアリングするには、パスを追加した後、行の末尾にある the Edit Outline icon ボタンをクリックし、 [ペアリングされたスペース] 列のドロップダウン リストから 1 つ以上のスペースを選択します。パスとスペースをペアリングすると、少なくとも 1 つのスペースに属しているユーザーのみが指定されたパスにアクセスできます。指定されたスペースのメンバーは、個人スペースを含む、所属するすべてのスペース (明示的に定義されていない場合でも) からパスにアクセスできます。

例

次の例では、 [ファイル パス] リストに 2 つのエントリが含まれています。

* 最初のエントリでは、必要なロールを持つすべてのユーザーが `C:\mypath\source.` にアクセスできます。

* 2 番目のエントリでは、mosheSharedSpace スペースのメンバーのみが `C:\restricted` にアクセスできます。

| ソース ファイル パス | ペアリングされたスペース |
| --- | --- |
| C:\mypath\source | スペースが選択されていません |
| C:\restricted | mosheSharedSpace |

エントリの編集または削除

エントリを編集するには、行の末尾にある the Edit Outline icon ボタンをクリックし、必要に応じてエントリを編集します。変更を保存するには the Tick icon を、変更を元に戻すには the Cross icon をクリックします。

エントリを削除するには、行の末尾にある the Bin Outline icon ボタンをクリックします。

関連記事: [ファイル (Direct Access gateway 経由)](https://help.qlik.com/en-US/cloud-services/Subsystems/Web_Storage_Provider_Connectors_help/Content/Connectors_StorageProvider/Storage%20provider%20connectors/File-DG-storage-provider-connector.htm) (英語のみ)。

### 接続ごとにチャンク リカバリを無効にする

情報メモDirect Access gateway 1.7.16 以降が必要です。

Direct Access gateway は、リロード操作中に破損したチャンク (暗号化されたデータ セグメント) を自動的にリカバリします。これにより、ネットワークの中断やデータ ソースの問題によってチャンクの消失が発生した場合でも、リロードを正常に完了させることができます。

デフォルトでは、すべての接続でチャンク リカバリが有効になっています。ただし、復元性よりもリロード速度を優先する場合や、ワークロードでリカバリが不要な場合には、接続ごとにこの機能を無効にできます。

特定の接続に対してチャンク リカバリを無効にするには、次を実行します。

1. Qlik Cloud テナントで、関連するコネクタを開きます。
2. [詳細] セクションを見つけます。
3. disableDataChunksRecovery (名前) を true (値) に設定します。
4. 変更内容を保存します。

Direct Access gateway パブリック API を介してチャンク リカバリを無効にすることもできます。API の詳細については、「[Direct Access Gateway REST API](https://qlik.dev/apis/rest/direct-access-agents/#put-api-v1-direct-access-agents-agentId-connectors-connectorType-files-fileType)」を参照してください。

情報メモ接続ごとの設定は、グローバルな [チャンク リカバリ期間のしきい値] 設定 (一般的なゲートウェイ設定で構成) よりも優先されます。これにより、接続ごとのきめ細かな制御が可能になります。

### 1.7.16 でのリロード パフォーマンスのモニタリング

情報メモDirect Access gateway 1.7.16 以降が必要です。

Direct Access gateway 1.7.16 には、リロード ストリームのスループットを自動的に向上させるパフォーマンス強化が含まれています。これらの最適化はデフォルトで有効になっており、設定は不要です。

次の改善点が含まれています。

* スレッド プール最適化: スレッド プール管理の強化により、高並行性のリロード時におけるオーバーヘッドが削減され、リソースの利用率が向上します。

* WebSocket プロトコルの機能強化: Direct Access gateway と Qlik Cloud の間の WebSocket 処理が改善されたことで、レイテンシーが短縮され、スループットが向上します。

* 適応型ペーシング: 動的ペーシング アルゴリズムがネットワーク状況とキューの深さに基づいてデータ転送速度を調整し、混雑やタイムアウトを防ぎます。

パフォーマンスの向上を確認するには、環境内のリロード時間とログを監視してください。以前のバージョンと比較して、リロード完了までの時間が短縮されるはずです。予期しない動作やパフォーマンスの低下が発生した場合は、[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)にお問い合わせください。

### 追加の ODBC (Direct Access gateway 経由) コネクタ設定

ODBC (Direct Access gateway 経由) コネクタを使用する場合、特定の DSN とドライバーの使用を制限し、既定のデータ タイプ マッピングを上書きできます。

情報メモ

* ODBC (Direct Access gateway 経由) コネクタにのみ関連します。

* UI で表示するには、Direct Access gateway 1.7.11 以降が必要です。

#### 特定の DSN のみを許可する

セキュリティまたは管理上の理由から、特定の DSN の使用を制限する必要がある場合があります。

操作方法

1. コネクタのリストから [ODBC] を選択し、 [DSN] セクションまでスクロールします。

2. 許可する DSN のみをオンに切り替えます。

   [ODBC (Direct Access gateway 経由)] コネクタ ダイアログで、 [システム DSN] が選択されている場合、許可された DSN のみが [ODBC ソース] ドロップダウン リストに表示されます。

3. Qlik Data Gateway - 直接アクセスサービスを再起動します。

#### 特定のドライバーのみを許可する

セキュリティまたは管理上の理由から、特定のドライバーの使用を制限する必要がある場合があります。

操作方法

1. コネクタのリストから [ODBC] を選択し、 [ドライバー] セクションまでスクロールします。

2. 許可するドライバーのみをオンに切り替えます。

3. Qlik Data Gateway - 直接アクセスサービスを再起動します。

   [ODBC (Direct Access gateway 経由)] コネクタ ダイアログで、 [ODBC ドライバー] が選択されている場合、許可されたドライバーのみが [ODBC ソース] ドロップダウン リストに表示されます。

#### 既定の Qlik Cloud データ タイプ マッピングをオーバーライドする

ベンダーの ODBC ドライバーによるソース データ型の取り扱いの問題により、リロード中にエラーが発生したり、正しくないデータが Qlik Cloud にロードされたりする場合があります。このような場合、ソースデータ型と Qlik Cloud データ型間の既定のマッピングをオーバーライドできます。

操作方法

1. コネクタのリストから [ODBC] を選択し、 [ドライバー] セクションまでスクロールします。

2. ドライバーを見つけて、行の最後にある ![](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/arrow_down.svg) をクリックし、セクションを展開します。

3. [データ タイプ マッピングを追加] をクリックします。

   次の列 (プロパティ) が表示されます。

   * ソース データ タイプ: ソース データ タイプ。

   * Qlik Cloud データ型: ソース データ タイプがマッピングされる Qlik Cloud 上のデータ タイプ。

   * サイズ: Qlik Cloud 上でマッピングされたデータ タイプのサイズ (精度)。

   * IsBit: マッピングされたデータ タイプがビット型 (1 または 0 の値を格納) であるかどうか。

4. 各プロパティを設定し、設定を保存します。

   マッピングは、次の例のように保存されます。

   | ソース データ タイプ | Qlik Cloud データ タイプ | サイズ | IsBit |
   | --- | --- | --- | --- |
   | タイム ゾーンがあるタイムスタンプ | 日付/時間 | 27 | false |

5. Qlik Data Gateway - 直接アクセスサービスを再起動します。

6. データをリロードします。

警告メモ多くの問題は QlikDataType を String に変更するだけで解決できますが、これができない場合は、ソース データ型をマップできる [Qlik データ型に関するガイダンスについて](https://community.qlik.com/t5/Support/ct-p/qlikSupport) サポートQlik Cloudに問い合わせることをお勧めします。

マッピングの編集と削除

マッピングを編集するには

* 行の最後で ![](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/edit.svg) をクリックし、必要に応じて列を編集します。

マッピングを削除するには

* 行の最後で ![](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/delete.svg) をクリックします。

### 設定の変更後に Direct Access gateway を再起動する

一部の設定は、Direct Access gateway サービスの再起動後にのみ適用されます。このような場合、設定を保存するときにサービスを再起動するように求められます。アクティブなリロードがある場合は、完了するまでサービスを再起動することはできません。アクティブなリロードがない場合は、次を実行していつでもサービスを再起動できます。

1. Qlik Cloud テナントで、管理 > [データ ゲートウェイ] に移動し、Direct Access gateway を見つけます。

2. 行の最後で the 詳細 icon をクリックし、[サービスの再起動] を選択します。

Direct Access gateway で説明されているように、[サービスの起動、停止、または再起動](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Starting) マシンで直接サービスを再起動することもできます

## Direct Access gateway マシン上で Direct Access gateway を直接設定する

ほとんどの Direct Access gateway 設定は [Qlik Cloudで構成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Configur)できますが、一部の設定は Direct Access gateway マシンで直接構成ファイルを編集することによってのみ変更できます。

### 既定のチャンク キャッシュ ディレクトリをオーバーライドする

情報メモDirect Access gateway 1.7.1 以降が必要です。

各リロード操作について、Direct Access gateway はデータチャンクをメモリにキャッシュし、それらをディスクにオフロードできます (キャッシュに割り当てられたサイズを超えた場合)。システム ドライブに十分なディスク容量がない場合は、既定のチャンク キャッシュ ディレク トリ (C:\ProgramData\Qlik\Gateway\tmp) ディレクトリをオーバーライドできます。

情報メモ安定性を確保し、パフォーマンスを最適化するには、ローカル パスのみを使用するのがベスト プラクティスです。

これを実行するには、次の手順に従います。

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. OVERRIDE\_CHUNKS\_CACHE\_DIR プロパティを見つけて、任意のディレクトリに設定します。

   例:

   OVERRIDE\_CHUNKS\_CACHE\_DIR=C:\tmp

   情報メモパスを引用符で囲まないでください。

3. configuration.properties ファイルを保存します。

4. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     「Qlik Data Gateway - 直接アクセス」の説明に従って [設定とトラブルシューティング Qlik Data Gateway - 直接アクセス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) サービスを再起動します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナを再起動します。

関連項目: [キャッシュ データ チャンク用メモリ](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Memory)

### Direct Access gateway を Qlik Cloud に再接続させる

既定では、Direct Access gateway が Qlik Cloud から切断された場合、45 秒後に再接続されます。再接続に時間がかかるようであれば、ゲートウェイを強制的に再接続させることができます。

これを実行するには、次の手順に従います。

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。このファイルには、Qlik Cloud データ型のサンプル ソースが含まれています。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. ファイルの先頭の # Connector Agent セクションに AGENT\_PONG\_TIMEOUT\_SECONDS=<time-in-seconds> を追加します。

   例:

   AGENT\_PONG\_TIMEOUT\_SECONDS=30

   情報メモ最短時間は 30 秒です。

3. configuration.properties ファイルを保存します。

4. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     「Qlik Data Gateway - 直接アクセス」の説明に従って [設定とトラブルシューティング Qlik Data Gateway - 直接アクセス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) サービスを再起動します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナを再起動します。

### ロード データの要求を非同期で実行

情報メモ

Direct Access gateway 1.7.5 以降が必要です。

エージェントでデータのロード要求を非同期で実行すると、クラウド サービスがエージェントからの応答を待つ時間が大幅に短縮されます。

非同期のデータのロード要求を有効にするには:

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. まだ既存のファイルがない場合は、次の行をファイルに追加してください。

   OPTIONAL\_CAPABILITIES=AsyncLoadDataRequest

   もし、OPTIONAL\_CAPABILITIES= がすでに別のパラメーター (AsyncLoadSlotRequest など) と一緒に存在する場合は、既存のパラメーターに、スペースなしのカンマで区切って追加するだけです。

   例:

   OPTIONAL\_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest

3. configuration.properties ファイルを保存します。

4. コンテナ化されたインストールの場合のみ: direct-access-agent コンテナを再起動します。

ヒント メモ変更は次回のリロードで反映されるため、Direct Access gateway サービスを再起動する必要はありません。すべての変更は connector-agent\_logs\_[date].txt ファイルに記録されます。

非同期のデータのロード要求を無効にするには:

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. OPTIONAL\_CAPABILITIES=None パラメータが他にある場合は、AsyncLoadDataRequest を設定するか、OPTIONAL\_CAPABILITIES を削除してください。

3. configuration.properties ファイルを保存します。

4. コンテナ化されたインストールの場合のみ: direct-access-agent コンテナを再起動します。

### ファイルを非同期でダウンロードする

情報メモDirect Access gateway 1.8.1 以降でサポートされています。

AsyncFileDownloadRequest はファイル コネクタのダウンロードにおけるオプション機能です。機能がネゴシエートされない場合、ファイルのダウンロードは同期のままです。

非同期のファイルのダウンロード リクエストを有効にするには:

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. まだ既存のファイルがない場合は、次の行をファイルに追加してください。

   OPTIONAL\_CAPABILITIES=AsyncFileDownloadRequest

   もし、OPTIONAL\_CAPABILITIES= がすでに別のパラメーター (AsyncFileDownloadRequest など) と一緒に存在する場合は、既存のパラメーターに、スペースなしのカンマで区切って追加するだけです。

   例:

   OPTIONAL\_CAPABILITIES=AsyncLoadDataRequest,AsyncFileDownloadRequest

3. configuration.properties ファイルを保存します。

ヒント メモ変更は次回のリロードで反映されるため、Direct Access gateway サービスを再起動する必要はありません。すべての変更は connector-agent\_logs\_[date].txt ファイルに記録されます。

非同期のファイルのダウンロード リクエストを無効にするには:

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. OPTIONAL\_CAPABILITIES=None パラメータが他にある場合は、AsyncFileDownloadRequest を設定するか、OPTIONAL\_CAPABILITIES を削除してください。

3. configuration.properties ファイルを保存します。

### 非同期でロード スロットを要求する

情報メモ

Direct Access gateway 1.7.7 以降が必要です。

リロード データ WebSocket を Qlik Cloud に作成する際に、Direct Access gateway への一時的なコマンド パイプの混雑を緩和するため、ロード スロットを非同期で要求します。これは、かなりの数のリロードを同時に行う場合に便利です。

情報メモ[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)の指示がある場合のみ、この機能を有効にしてください。

非同期のスロットのロード要求を有効にするには:

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. まだ既存のファイルがない場合は、次の行をファイルに追加してください。

   OPTIONAL\_CAPABILITIES=AsyncLoadSlotRequest

   もし、OPTIONAL\_CAPABILITIES= がすでに別のパラメーター (AsyncLoadDataRequest など) と一緒に存在する場合は、既存のパラメーターに、スペースなしのカンマで区切って追加するだけです。

   例:

   OPTIONAL\_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest

3. configuration.properties ファイルを保存します。

ヒント メモ変更は次回のリロードで反映されるため、Direct Access gateway サービスを再起動する必要はありません。すべての変更は connector-agent\_logs\_[date].txt ファイルに記録されます。

非同期のスロットのロード要求を無効にするには:

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. OPTIONAL\_CAPABILITIES=None パラメータが他にある場合は、AsyncLoadSlotRequest を設定するか、OPTIONAL\_CAPABILITIES を削除してください。

3. configuration.properties ファイルを保存します。

### コネクタの起動設定

コネクタ起動のタイムアウト値と試行回数を増やすことができます。これは、かなりの数のリロードを同時に行う場合に便利です。これらのパラメーターを増やすと、Direct Access gateway は、失敗して終了し、再起動を必要とする前に、より多くの時間と試行回数でコネクタを実行するようになる。

情報メモ[Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)の指示がある場合のみ、この機能を有効にしてください。

情報メモ

Direct Access gateway 1.7.7 以降が必要です。

コネクタの起動パラメーターを調整します。

1. テキスト エディターを使用して、次のファイルを管理者として開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

   * Windows サーバーのインストール:

     C:\ProgramData\Qlik\Gateway\configuration.properties

   * コンテナ化されたインストール:

     /usr/share/Qlik/Gateway/configuration.properties

2. ファイルに次の行を追加します。

   # CONNECTOR STARTUP TIMEOUT between 30 and 120 seconds

   CONNECTOR\_STARTUP\_TIMEOUT\_SECONDS=your-value

   # CONNECTOR STARTUP MAX ATTEMPTS between 1 and 5

   CONNECTOR\_STARTUP\_MAX\_ATTEMPTS=your-value

   情報メモコマンド パイプの輻輳を防ぐために、これらの値を調整するには、上記のロード スロットを非同期に要求するで説明したように、AsyncLoadDataRequestを有効にする必要があります。AsyncLoadSlotRequest が無効になると、これらの設定はそれぞれ 30 と 3 の固定レガシー値に戻ります。

3. configuration.properties ファイルを保存します。

4. コンテナ化されたインストールの場合のみ: direct-access-agent コンテナを再起動します。

### プロセス分離によって設定されたデフォルトの開始ポートのオーバーライド

プロセス分離が有効になっている場合、Direct Access gateway がすべての分離されたコネクタ プロセスとのプロセス間通信に使用するデフォルトの開始ポート (49152) をオーバーライドできるようになりました。これは、デフォルトポートが別のプロセスによって使用されている場合に役立ちます。

情報メモ

* [Qlik サポート](https://community.qlik.com/t5/Support/ct-p/qlikSupport)の指示がある場合のみ、この機能を有効にしてください。

* Direct Access gateway 1.7.8 以降が必要です。

* この機能は、[パブリック API](https://qlik.dev/apis/rest/direct-access-agents/) 経由でもサポートされています。

これを実行するには、次の手順に従います。

1. テキスト エディターを使用して、管理者として C:\ProgramData\Qlik\Gateway\configuration.properties を開きます。Windows エクスプローラーで実行する場合は、 [表示 ] > [非表示のアイテム] が選択されていることを確認してください。

2. # Connector Agent セクションで、ファイルに次の行を追加します。

   DATA\_PORT\_RANGE\_START=port-value

   port-value はデフォルトの開始ポートです。

3. configuration.properties ファイルを保存します。

4. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     「Qlik Data Gateway - 直接アクセス」の説明に従って [設定とトラブルシューティング Qlik Data Gateway - 直接アクセス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) サービスを再起動します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナを再起動します。

## メトリクス コレクター

一般的な顧客の環境では、毎日多数のデータリロードが Direct Access gateway を介して Qlik Cloud Analytics に渡されます。これらのリロードによって影響を受けるリソースの消費と使用率をログに記録して監視する機能は、顧客がそれに応じてリロードを計画するのに役立ちます。

新しいメトリクス コレクター (Direct Access gateway マシンのバックグラウンドで実行) は、Direct Access gateway、コネクタ、オペレーティング システムによるリソース使用率の基本的なログ記録と監視を提供します。メトリクス コレクターは、JSON ファイルでローカルに構成することも、[パブリック API](https://qlik.dev/apis/rest/direct-access-agents/) 経由で構成することもできます。

### メトリクス コレクターを構成する

Direct Access gateway マシンで次のファイルを開き、必要に応じて構成します。

* Windows サーバーのインストール:

  <INSTALL\_DIR>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

* コンテナ化されたインストール:

  /usr/runMetricsCollector/metricscollectorsettings.json

#### コレクター設定の構成 (MetricsCollectorSettings)

* `Enabled`: `true` (既定) に設定するとメトリクス収集が有効になり、`false` に設定すると無効になります。

* `BaseScrapeIntervalSeconds`: コネクタメトリクスをポーリングする頻度 (秒単位)。コネクタごとにポーリング間隔は異なります。

* `Port`: API またはメトリクス コネクタが使用するポート (Direct Access gateway 経由の REST)。

* `LocalDataRetentionDays`: 指定した値よりも古いデータはローカル データベースから削除されます。

* `localDataRetentionDatabaseSizeInMb:` ゲートウェイ マシンに保存するメトリクス データの合計サイズ (MB)。既定は 500 MB です。クォータが超過しないように、古いデータは削除されます。

  情報メモ

  * Direct Access gateway 1.7.10 以降が必要です。

  * 多数の同時リロードでは、既定値を増やす必要がある場合があります。たとえば、60 件の同時リロードを行うテナントでは、最大 1 GB が必要になる場合があります。

* `DataRetentionCheckIntervalMinutes`: 保持チェックの頻度。

* `LocalDatabaseFileLocation`: ローカル データベースの場所。UNC パスも指定できます。デフォルトの場所は次のとおりです。

  * Windows サーバーのインストール:

    C:\ProgramData\Qlik\Gateway\tmp

  * コンテナ化されたインストール:

    /usr/share/Qlik/Gateway/tmp

#### コネクタ設定の構成 (ConnectorConfigurations)

すべての Direct Access gateway コネクタに対して、メトリクス ポーリング間隔 (`ScrapeIntervalSeconds`) を設定し、メトリクス収集を有効 (`true`) または無効 (`false`) にできます。

#### metricscollectorsettings.json ファイルの例

```
{
  "MetricsCollectorSettings": {
    "Enabled": true,
    "BaseScrapeIntervalSeconds": 1,
    "Port": 5052,
    "LocalDataRetentionDays": 30,
    "localDataRetentionDatabaseSizeInMb": 500,
    "DataRetentionCheckIntervalMinutes": 60,
    "LocalDatabaseFileLocation": ""
  },
  "ConnectorConfigurations": {
    "OdbcConnector": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "SystemMetrics": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "ConnectorAgent": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "RestConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapSqlConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapBwConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapPackageConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "FileConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    }
  }
}
```

### メトリクスのロード

REST (Direct Access gateway 経由) コネクタを使用して、Direct Access gateway マシンからメトリックを収集します。

これを実行するには、次の手順に従います。

1. REST (Direct Access gateway 経由) 接続設定で、 [Allow working with localhost connection] (localhost 接続での動作を許可する) を有効にします。

   詳細については、「[REST 接続の作成](https://help.qlik.com/en-US/cloud-services/Subsystems/REST_Connector_help/Content/Connectors_REST/Create-REST-connection/Create-REST-connection.htm) (英語のみ)」を参照してください。

2. 許可された URL のリストに http://localhost:5052/api/metrics を追加します。

   上記の「[Direct Access gateway が REST コネクタを使用してアクセスできる URL を制限する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Limiting)」を参照してください。

3. Direct Access gatewayサービスを再起動します。

4. アプリケーションを作成し、REST (Direct Access gateway 経由) 接続を介して http://localhost:5052/api/metrics からメトリクスをロードします。

### サポートされているメトリクス

* システム メトリクス:

  * network\_bytes\_sent\_total: システム起動以降、Direct Access gateway を介して送信されたバイトの総数

  * 受信バイト数の合計: システム起動以降、Direct Access gateway を介して受信されたバイトの総数

* コネクタ メトリクス:

  * process\_start\_time\_seconds: プロセス開始からの経過時間 (秒単位)。

  * process\_cpu\_seconds\_total: CPU が特定の状態にあった累積秒数

  * process\_virtual\_memory\_bytes: プロセスが消費している仮想メモリの現在のサイズ (バイト単位)。

  * process\_working\_set\_bytes: プロセスのワーキング セットの現在のサイズ (バイト単位)。

  * process\_private\_memory\_bytes: プロセスが消費しているプライベート メモリの現在のサイズ (バイト単位)。

  * process\_num\_threads: プロセスが使用しているスレッド数。

## ログ ファイルの表示とダウンロード

ログ ファイルは、Direct Access gateway 操作の情報を提供します。Qlik サポートは、トラブルシューティングの目的でログ ファイルの提供を依頼する場合があります。ログ ビューアでログ ファイルを表示したり、ダウンロードしたりできます。通常の状況下では、ログ ファイルを確認する必要はありませんが、失敗が繰り返されたり、その他の問題が発生したりした場合に、ログ ファイルは原因を特定する助けになります

情報メモログの表示とダウンロードには、[データ消費可能] のロールが必要です。

ログ ビューアを開くには、

1. 管理 アクティビティ センターで、 [データ ゲートウェイ] に移動し、Direct Access gateway を検索します。

2. 行の最後で the 詳細 icon をクリックし、[ログを表示] を選択します。

   [ログ ビューア] ウィンドウが開きます。

3. 左上のドロップダウン リストから、Qlik サポートが表示またはダウンロードするように依頼したログのタイプを選択します。

   次のログを使用できます。

   * Direct Access gateway のログ (DirectAccessAgent)

   * DCaaS のログ (dcaas\_logs)

   * ODBC ベースのコネクタのログ (odbc-connector\_logs)

   * SAP BW コネクタのログ (QvSAPBwConnector-<date + timestamp>)

   * SAP SQL コネクタのログ (QvSqlBwConnector-<date + timestamp>)

   * コネクタ エージェントのログ (connector-agent\_logs\_<date>)

   * SAP ODP および SAP Report コネクタのログ (QvSapConnectorPackage-<process\_id>)

   * REST コネクタのログ (rest-connector\_logs\_<timestamp>)

   * ファイル コネクタのログ (file-connector\_logs\_<timestamp>)

   情報メモDirect Access gateway 1.7.1以降では、コネクタの開始、終了、再起動イベントは Direct Access gateway (DirectAccessAgent) ログ ファイルに書き込まれます。以前のバージョンでは、コネクタ エージェント ログ (connector-agent\_logs\_<date>) ログ ファイルに書き込まれていました。

4. 隣接するドロップダウン リストから、表示またはダウンロードするログを選択します。ログ ファイルは、最新のファイル (現在アクティブのログ ファイル) から降順に並べ替えられます。ログ ファイルを選択した後、the 上へスクロールする矢印 icon と the 下へスクロールする矢印 icon ボタンを使用してログ ファイルの最初または終わりに移動します。

   ヒント メモログ ファイルのビューは、最新のメッセージで自動的に更新されません。ビューを更新するには、the 下へスクロールする矢印 icon をクリックして、最新のメッセージで更新されたログ ファイルの最後まで移動します。

5. ログ ファイルをダウンロードするには、[ダウンロード] をクリックします。

   ブラウザの設定により、ファイルがコンピュータにダウンロードされるか、保存するように促すメッセージが表示されます。

### Direct Access gateway マシンで Direct Access gateway ログを開く

Direct Access gateway (DirectAccessAgent) のログは 管理 アクティビティ センター からダウンロードできるだけでなく、Direct Access gateway マシンから直接開くこともできます。

既定のインストールでは、これらのログの場所は次の通りです。

C:\Program Files\Qlik\ConnectorAgent\data\logs

* Windows サーバーのインストール:

  C:\Program Files\Qlik\ConnectorAgent\data\logs

* コンテナ化されたインストール:

  /usr/data/logs

#### DirectAccessAgent ログ レベルの変更

トラブルシューティングの目的で、DirectAccessAgent ログのログ レベルを変更する必要がある場合があります。DirectAccessAgent は、Qlik Cloud サービスへの接続を担当します。DirectAccessAgent ログのログ詳細レベルを表示および変更するには、ConnectorAgent サブフォルダー (既定のインストールの場合は C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) から次のコマンドを実行します。

* 現在のログ レベルを表示するには、次を実行します。

  * Windows サーバーのインストール:

    connectoragent configuration getloggers

  * コンテナ化されたインストール:

    dotnet ConnectorAgent.dll configuration getloggers

* ログ レベルを Trace に設定するには、次を実行します。

  * Windows サーバーのインストール:

    connectoragent configuration setloggers -l Root -v DEBUG

  * コンテナ化されたインストール:

    dotnet ConnectorAgent.dll configuration setloggers -l Root -v DEBUG

* ログ レベルを Verbose に設定するには、次を実行します。

  * Windows サーバーのインストール:

    connectoragent configuration setloggers -l Root –v DETAILED\_DEBUG

  * コンテナ化されたインストール:

    dotnet ConnectorAgent.dll configuration setloggers -l Root –v DETAILED\_DEBUG

その他のロギング オプションについては、Qlik Cloud の「Direct Access gateway を設定する」を参照してください。

## 登録キーの更新

まれですが、登録キーが破損した場合や、データゲートウェイサーバーが不正にアクセスされたと思われる場合は、登録キーの変更が必要な場合があります。

登録キーを更新するには:

1. インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     Direct Access ゲートウェイ サーバーで、コマンド プロンプトを開いて、ConnectorAgent サブフォルダーの作業ディレクトリ (デフォルト インストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) を変更します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナ内でコンソールを開きます。

2. 次のコマンドを実行します。

   * 新規キーを生成します。

     * Windows サーバーのインストール:

       connectoragent qcs generate\_keys

     * コンテナ化されたインストール:

       dotnet ConnectorAgent.dll qcs generate\_keys

   * キーを表示します。

     * Windows サーバーのインストール:

       connectoragent qcs get\_registration

     * コンテナ化されたインストール:

       dotnet ConnectorAgent.dll qcs get\_registration

     キーが表示されます。

     ![Direct Access 登録キーの画像](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/da_reg_key.png)

3. 上の例のように、キー全体をコピーします。

4. 管理 アクティビティ センターで、関連する行の終わりにある [the 詳細 icon] ボタンをクリックして、 [編集] を選択することにより、データ ゲートウェイ設定を開きます。

5. キーを [キー] フィールドに貼り付けて (現在のキーを置換する)、設定を保存します。

6. Direct Access gateway サーバーに戻り、インストール ワークフローに応じて、次のいずれかの操作を実行します。

   * Windows サーバーのインストール:

     「Qlik Data Gateway - 直接アクセス」の説明に従って [設定とトラブルシューティング Qlik Data Gateway - 直接アクセス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm#Managing) サービスを再起動します。

   * コンテナ化されたインストール:

     direct-access-agent コンテナを再起動します。