Inspect configuration errors with the Windows Event Viewer or check the configuration by manually starting the extractor from a Windows shell.
Extractor service errors
You'll find error logs in the Windows Event Viewer under Windows Logs > Application.
Config file not found
When you install the extractor, the configuration file is not yet in the config folder. When the service starts, it fails with
Config file not found. Prepare a configuration file, add it to the configuration folder and restart the service.
Config version is not supported by this extractor
If you use an older version of the configuration file, the error message
Config version is not supported by this extractor appears. Replace the configuration file and restart the service.
Failed to load config at line...
Syntax errors in the configuration file will produce error events. See the configuration settings for a list of all configuration options.
Extractor upgrade errors
Event 1000, Application error
The extractor service stops after an upgrade with this error in the Windows logs. To resolve this, stop all extractor services, uninstall the extractor, install the new version, and restart the services.
Data loss incidents
Many data loss incidents are related to client-bound queue overflows:
[ERR] [PiSystem.PiConnection] Loss incident on the String data pipe: Overflow.
To resolve this, change the
TotalUpdateQueue PI server settings.
If you still experience many data loss incidents (overflow or otherwise), see [PI Replace Utility] for how to correct any data points inconsistencies in CDF.
Requests to CDF time out
Requests to CDF fail with this message:
[2021-06-25 06:02:21.188 WRN] [CogniteSdk.Client] Uploading data points to CDF timed out. Consider reducing the chunking sizes in the config file
[2021-06-25 06:02:21.188 WRN] [CommonUtil.CDFDestination] Uploading data points to CDF timed out. Consider reducing the chunking sizes in the config file
[2021-06-25 06:02:21.188 ERR] [PiExtractor.Extractor] Task failed: Streamer - One or more errors occurred.
CommonUtil.DestinationException: Request to CDF timeout after retry
To resolve this, consider reducing the extractor chunking configuration. In particular, reduce the number of time series per data point insert requests:
Cannot resolve remote name
Requests to CDF fail with the following:
[DBG] [CogniteSdk.Client] Request timed out or failed with message: An error occurred while sending the request. Retrying in 125 ms.
[DBG] [CogniteSdk.Client] Inner exception: The remote name could not be resolved: ....
[ERR] [PiExtractor.Program] Unhandled exception: An error occurred while sending the request.
System.Net.Http.HttpRequestException: An error occurred while sending the request. ---> System.Net.WebException: The remote name could not be resolved: ....
To resolve, check if the extractor is running behind a proxy server and follow these instructions to configure the extractor to use a proxy server.