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

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

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

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

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

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

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

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

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

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

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

   設定は、一般設定 (以下) と コネクタ設定に分かれています。設定を変更すると、Direct Access gateway サービスの再起動も必要になる場合があることに注意してください。

一般設定

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

エージェント ID

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

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

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

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

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

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

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

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 サポートから要求された場合にのみ変更してください。

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

特定のコネクタ エージェント コンポーネントに関する問題をトラブルシューティングするには、対応するログ ファイルを選択する必要がある場合があります。 この設定は、Qlik サポートから要求された場合にのみ変更してください。

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

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

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

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

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

DCaaS ポート

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

DCaaS ロギング レベル

トラブルシューティングの目的で、DCaaS ログのログ レベルを変更する必要がある場合があります。 この設定は、Qlik サポートから要求された場合にのみ変更してください。

コネクタ設定

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

ポート

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

ロギング レベル

トラブルシューティングのために、コネクタ ログのロギング レベルを変更する必要がある場合があります。 この設定は、Qlik サポートから要求された場合にのみ変更してください。

プロセス分離

プロセス分離により、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 と Qlik Cloud の間の接続が 20 秒以上アイドル状態である場合、リロード操作が次のエラーで失敗することがあります。

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

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

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

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

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

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

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

例

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

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

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

URL の編集または削除

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

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

関連記事: REST 接続の作成 (英語のみ)。

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

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

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

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

例

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

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

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

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

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

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

関連記事: ファイル (Direct Access gateway 経由) (英語のみ)。

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

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

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

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

サービスの起動、停止、または再起動 で説明されているように、Direct Access gateway マシンで直接サービスを再起動することもできます

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

ほとんどの Direct Access gateway 設定は Qlik Cloudで構成できますが、一部の設定は Direct Access gateway マシンで直接構成ファイルを編集することによってのみ変更できます。

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

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

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

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

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

   例:

   OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

   情報メモパスを引用符で囲まないでください。
3. configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセス サービスを再起動します。

参照先: キャッシュ データ チャンク用メモリ

ODBC (Direct Access gateway 経由)コネクタを使用するときに、既定の Qlik Cloud データ型をオーバーライドする

ベンダーの ODBC ドライバーによるソース データ型の取り扱いの問題により、リロード中にエラーが発生したり、正しくないデータが Qlik Cloud にロードされたりする場合があります。このような場合、Qlik Cloud データ型またはその仕様 (スケールや精度など) をオーバーライドできます。

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

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

2. 問題のあるデータ型を目的の Qlik Cloud データ型にマッピングするセクションを追加します。

   次の例 (custom_type_mappings.json ファイルに含まれています) では、顧客は Qlik Cloud DateTime データ型のサイズを 27 に変更する必要があります。

    

   例:

   {
   "Identifier": "Amazon Athena ODBC (x64)",
   "NativeDataType": "timestamp with time zone",
   "QlikDataType": "DateTime",
   "Size": 27,
   "IsBit": false
   }

3. custom_type_mappings.json ファイルを保存し、Qlik Data Gateway - 直接アクセス サービスを再起動します。
4. データをリロードします。

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

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

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

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

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

   例:

   AGENT_PONG_TIMEOUT_SECONDS=30

   情報メモ最短時間は 30 秒です。
3. configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセス サービスを再起動します。

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

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

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

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

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

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

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

   例:

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest

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

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

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

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

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

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

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

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

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

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

   OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest

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

   例:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest

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

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

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

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

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

コネクタの起動設定

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

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

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

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 ファイルを保存します。

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

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

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

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

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

   DATA_PORT_RANGE_START=port-value

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

3. configuration.properties ファイルを保存し、Qlik Data Gateway - 直接アクセス サービスを再起動します。

ODBC データ ソースへの接続時にエラー メッセージの詳細を増やす

セキュリティ上の懸念から、ODBC ドライバーによって返される既定のエラー メッセージには最小限の情報しか含まれていません。ただし、特定のシナリオでは、特定の問題をトラブルシューティングするために、さらなる情報が必要になる場合があります。より詳細なエラー メッセージを取得するには、コネクタ ダイアログの [詳細] セクションに ShowErrorDetailMessage プロパティを追加し、True に設定します。問題が解決したら、セキュリティを最適化するために、プロパティを削除するか、False に設定することを強くお勧めします。

メトリクス コレクター

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

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

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

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

<INSTALL_DIR>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

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

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

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

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

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

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

• LocalDatabaseFileLocation: ローカル データベースの場所。UNC パスも指定できます。既定の場所は C:\ProgramData\Qlik\Gateway\tmpです。

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

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

metricscollectorsettings.json ファイルの例

{
  "MetricsCollectorSettings": {
    "Enabled": true,
    "BaseScrapeIntervalSeconds": 1,
    "Port": 5052,
    "LocalDataRetentionDays": 30,
    "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 接続の作成 (英語のみ)」を参照してください。

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

   上記の「Direct Access gateway が REST コネクタを使用してアクセスできる URL を制限する」を参照してください。

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

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

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

• システム メトリクス:

  • network_bytes_sent_total: システム起動以降、Direct Access gateway を介して送信されたバイトの総数

  • network_bytes_received_total: システム起動以降、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. 行の最後で をクリックし、[ログを表示] を選択します。

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

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

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

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

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

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

Direct Access gateway (DirectAccessAgent) のログは 管理 アクティビティ センター からダウンロードできるだけでなく、Direct Access gateway マシンから直接開くこともできます。既定のインストールでは、これらのログの場所は次の通りです。

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

DirectAccessAgent ログ レベルの変更

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

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

  connectoragent configuration getloggers

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

  connectoragent configuration setloggers -l Root -v DEBUG

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

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

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

登録キーの更新

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

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

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

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

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

     connectoragent qcs generate_keys

   • キーを表示します。

     connectoragent qcs get_registration

     キーが表示されます。

     

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

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

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

6. Direct Access ゲートウェイ サーバーに戻り、「Qlik Data Gateway - 直接アクセス サービスの管理」の説明に従って Qlik Data Gateway - 直接アクセス サービスを再起動します。