オンプレミスのランタイムとパフォーマンスの問題 ​

このガイドでは、オンプレミスエージェント（OPA）のランタイム中に発生する可能性がある問題について説明します。 これには、ヒープスペースエラー、大きなAPIレスポンスによるクラッシュ、ロギングエラー、ロングクエリエラー、データベースコネクションの切断が原因で停止するジョブが含まれます。

Javaヒープ領域エラー ​

次のエラーログは、エージェントがメモリ上限に達したことを示します：

java.lang.OutOfMemoryError: Java heap space

このエラーは、大きなジョブまたはペイロードを処理するための十分なメモリがOPAにないことを示します。 デフォルトでは、ヒープサイズは利用可能なシステムメモリの一部に設定されます。

問題を解決するには、run.shファイルを開き、-Xmxフラグを調整します。 たとえば、-Xmx10Gに増やして、10 GBのヒープメモリを割り当てることができます。

大きなレスポンスによる高いメモリ利用状況 ​

エージェントが大きなAPIレスポンスをメモリにバッファリングすると、クラッシュまたは速度低下が発生する場合があります。 デフォルトでは、実行中にレスポンス全体が読み込まれるため、メモリ利用状況が増加します。

OPAバージョン2.7.1以降では、config.ymlに次のフラグを追加することで、設定ファイルでレスポンスのバッファリングを無効にできます：

agent:
  disable_response_buffering: true

OPAがインストールされているサーバーでのゲートウェイ名の解決 ​

OPAがインストールされているサーバーでWorkatoゲートウェイ名を解決する際に、次のエラーが発生する場合があります：

• sg3.workato.com
• sg4.workato.com

ゲートウェイ名を解決するには、次のトラブルシューティング手順を実行します：

sg3.workato.com	canonical name = public-v10-awsprod-opg3-nlb-d6da47859547995a.elb.us-east-1.amazonaws.com.
Name:	public-v10-awsprod-opg3-nlb-d6da47859547995a.elb.us-east-1.amazonaws.com
Address: 54.224.75.148
Name:	public-v10-awsprod-opg3-nlb-d6da47859547995a.elb.us-east-1.amazonaws.com
Address: 52.206.161.203
Name:	public-v10-awsprod-opg3-nlb-d6da47859547995a.elb.us-east-1.amazonaws.com
Address: 52.204.114.159

ゲートウェイ接続の確認 ​

OPAがインストールされているサーバーで、ゲートウェイ接続の確立に関する問題が発生する場合があります。

ゲートウェイ接続を確認するには、次のトラブルシューティング手順を実行します：

curl -k -vvv -GET --no-alpn --key conf/cert.key --cert conf/cert.pem https://sg3.workato.com/gateway/ping

* TLSv1.2 (IN), TLS handshake, Finished (20):
* SSL connection using TLSv1.2 / ECDHE-RSA-AES128-GCM-SHA256
*
(LINES SKIPPED)
>
< HTTP/1.1 200 OK
< Content-Type: application/json
< Date: Mon, 25 Jul 2022 21:33:42 GMT
< Content-Length: 81
<
{"gateway_version":"1.0.1","os_platform":"linux","os_release":"4.19.0-10-amd64"}

サーバー証明書チェーンの検証 ​

OPAがインストールされているサーバーで、サーバー証明書チェーンの検証に関する問題が発生する場合があります。

サーバー証明書チェーンを検証するには、次のトラブルシューティング手順を実行します：

curl -vvv -GET --no-alpn --cacert root_ca_cert.pem --key conf/cert.key --cert conf/cert.pem https://sg3.workato.com/gateway/ping

OPAがログの作成を停止した場合 ​

Linuxで実行している場合、OPAがログの生成を停止する問題が発生する場合があります。 この問題は、ディスクに空き容量が残っていない場合、またはロギングレベル設定が正しくない場合に発生します。 この問題を解決するには、次のトラブルシューティング手順を実行します：

df -h
cat /etc/fstab
parted -l

chown -R workato:workato /var/log/workato-agent

切断されたTCPコネクションが原因でジョブが無期限に停止する ​

エラーやタイムアウトが発生せずにハングするジョブは、多くの場合、OPAとデータベース間のアイドル状態のTCPコネクションがファイアウォールまたはNATデバイスによって暗黙的に切断されることが原因です。 ソケットを保持しているJVMスレッドは通知を受け取らず、レスポンスを無期限に待機します。

OSレベルでTCP keepaliveを構成して、アイドル状態のコネクションを定期的にプローブし、コネクションが切断されたタイミングを検出できます。これにより、停止したスレッドが失敗してリカバリできるようになります。

Linuxのキープアライブ設定の構成 ​

Linuxでキープアライブ設定を構成するには、次の手順を実行します。

net.ipv4.tcp_keepalive_time = INITIAL_WAIT
net.ipv4.tcp_keepalive_intvl = INTERVAL
net.ipv4.tcp_keepalive_probes = NUMBER_OF_PROBES

net.ipv4.tcp_keepalive_time = 300
net.ipv4.tcp_keepalive_intvl = 5
net.ipv4.tcp_keepalive_probes = 3

sudo sysctl -p

Windowsのキープアライブ設定の構成 ​

Windowsでキープアライブ設定を構成するには、次の手順を実行します。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters

長いクエリエラー ​

MySQLなどのデータベースコネクターでオンブレミスファイルコネクターを使用すると、次のエラーが発生する場合があります:

Long query error: java.lang.IllegalArgumentException: Missing files profile laws rds cx

このエラーは、オンブレミスファイルコネクターとデータベースコネクターが異なるオンプレミスグループを使用している場合に発生します。 このエラーを解決するには、両方のコネクションで同じオンプレミスグループ内のエージェントを使用するように設定します。