Troubleshooting

1) The Agent does not start

• Check whether there is a syntax error in the configuration file.
• Check the Java runtime environment and permissions.
• Check the permissions on the log file creation path.

2) Sending is delayed

• Check the queue backlog and the TPS/session settings.
• Check for DB response delay and network delay.
• Check the external API response time and error rate.

3) Results are not being applied

• Check the operating status of the Receiver and the schedulers.
• Check the report receiving path and the firewall policy.
• Check the state transition condition logic (msg_status and so on).

4) Duplicate sends occur

• Check the key design (idempotencyKey, ref, internal PK).
• Review the reprocessing criteria used during failure recovery.
• Check the policy that prevents duplicate execution (lock) during HA switchover.

Recommended incident response order

1. First isolate the affected stage (collection/sending/receiving/migration).
2. Check the recent change history (configuration/deployment).
3. Narrow down the cause based on logs and metrics.
4. After the temporary fix, apply the items that prevent the root cause from recurring.