This collector has different security layers that detect both an invalid configuration and abnormal operation. This table will help you detect and resolve the most common errors.
2
| File <filename> Unable to refresh token or client Auth was deleted. Detail: <error_message>
To know how the token is regenerated, consult the section Vendor setup. |
SetupError |
1
| 101 | Error | This error is raised when |
the token unknown error occurs while loading token.pickle | Check that the token.pickle is in the correct format and if not, regenerate it again. |
SetupError | 102 | HTTP error: <error_message> | This error is raised when an HTTP error appears during setup. | The solution depends on the type of error. Contact with Devo Support team. |
SetupError | 103 | Unable to refresh token or client Auth was deleted. Detail: <error_message> | This error is raised when the token cannot be refreshed. The reason may be that it has been deleted. | Regenerate the token.json and save it in the file devo-collector-gsuite-google-workspace-alerts/credentials/. |
To know how the token is regenerated, consult the section Vendor setup. |
InputConfigurationError
<input_config_environment_key_path> property must be a string
70
| 104 | Operation timed out: <error_message> | This error is raised when |
optional value environment
is not in the str format.Edit the value of environment in the configuration file so it is of valid str format. | 71
| <input_config_environment_key_path> property must fulfil the regex pattern r'^[A-Za-z0-9_-]{1,32}$'
the maximum time to wait for the connection has been exceeded. | Check that the connection is working properly. |
SetupError | 105 | HTTP/1.1 503 Service Unavailable at moment - Retrying reconnection: <error_message> | This error is raised when |
optional value environment
does not match the required regex.Make the value of environment in the configuration file match the indicated format. | GSuiteAlertsPullerConnectionLostException
| 0
HTTP/1.1 503 Service Unavailable at moment - Retrying reconnection: <error_message>
the service is not available. | This is an internal issue. Contact the support team. |
SetupError | 106 | DefaultCredentials: <error_message> | This error is raised when credentials cannot be automatically determined. | This is an internal issue. Contact the support team. |
InitVariablesError | 1 | start_time is not set as per the datetime_format | Start time in config is not as per right format | Put start time in the correct format. |
InitVariablesError | 2 | Date {initial_start_time_str} is in the future | Start time in config is in future | Put start time less than the current UTC time. |
PullError | 300 | Operation timed out: <error_message> | This error is raised when the maximum time to wait for the connection has been exceeded. | Check that the connection is working properly. |
PullError |
1
| 301 | Could not automatically determine credentials. | This error is raised when |
the service is not availableDefaultCredentials: <error_message>
credentials are not loaded successfully. | This is an internal issue. Contact the support team. |
2
| PullError | 302 | The <next_timestamp> value cannot be calculated, please check the related error logs. | This error is raised when |
credentials cannot be automatically determined1
| timestamp is invalid. | This is an internal issue. Contact the support team. |
0
| Operation timed out
| This error is raised when the maximum time to wait for the connection has been exceeded. | Check that the connection is working properly. |
PullError | 303 | HTTP/1.1 503 Service Unavailable at moment - Retrying reconnection |
.This error is raised when the service is not available. | This is an internal issue. Contact the support team. | 3
| <error_message>
| This error is raised when credentials cannot be automatically determined. | This is an internal issue. Contact the support team. |
GSuiteAlertsPullerCreationException
| 1
| <module_properties_key_path> mandatory property is missing or empty'
| This error is raised when module_properties property is not found in collector_definitions.yaml | This is an internal issue. Contact the support team. |
2
| <module_properties_key_path> property must be a dictionary
| This error is raised when module_properties is defined in the collector_definitions.yaml file but the format is not dict . | This is an internal issue. Contact the support team. |
3
| <module_properties_key_path>.alert_type mandatory property is missing or empty
| This error is raised when alert_type property is not found in collector_definitions.yaml | This is an internal issue. Contact the support team. |
4
| <module_properties_key_path>.alert_type property must be a string
| This error is raised when alert_type is defined in the collector_definitions.yaml file but the format is not str . | This is an internal issue. Contact the support team. |
5
| <module_properties_key_path>.tag_base mandatory property is missing or empty
| This error is raised when tag_base property is not found in collector_definitions.yaml | This is an internal issue. Contact the support team. |
6
| <module_properties_key_path>.tag_base property must be a string
| This error is raised when tag_base is defined in the collector_definitions.yaml file but the format is not str . | This is an internal issue. Contact the support team. |
7
| <module_properties_key_path>.credentials_scopes" mandatory property is missing or empty
| This error is raised when credentials_scopes property is not found in collector_definitions.yaml | This is an internal issue. Contact the support team. |
8
| <module_properties_key_path>.credentials_scopes" property must be a string
| This error is raised when credentials_scopes is defined in the collector_definitions.yaml file but the format is not str . | This is an internal issue. Contact the support team. |
9
| <input_config_key_path> property must be a dictionary
| This error is raised when the required property input_config_key_path is not found in the config file. | Add input_config_key_path to config file, for example: gsuit_alerts: |
10
| <input_config_credentials_key_path> mandatory property is missing or empty
| This error is raised when the required property credentials is not found in the config file. | Add credentials dictionary in config. |
11
| <input_config_credentials_key_path> property must be a dictionary
| This error is raised when credentials is defined in the config file but the format is not dict . | Edit the value of credentials in config file, so it is of valid dict format. |
12
| <input_config_credentials_key_path>.filename mandatory property is missing or empty
| This error is raised when the required property filename is not found in the config file, into credentials dictionary. | Add filename property in config file, into credentials dictionary. |
13
| <input_config_credentials_key_path>.filename property must be a string
| This error is raised when filename is defined in the config file but the format is not str . | Edit the value of filename in config file, so it is of valid str format. |
14
| <input_config_credentials_key_path>.content_base64" property must be a string
| This error is raised when content_base64 is defined in the config file but the format is not str . | Edit the value of content_base64 in config file, so it is of valid str format. |
15
| <input_config_credentials_key_path>.content_base64" must be in a valid base64 format
| This error is raised when content_base64 is defined in the config file but the format is not base64 string . | Edit the value of content_base64 in config file, so it is of valid base64 string format. |
16
| <input_config_credentials_key_path>.delegated_email mandatory property is missing or empty
| This error is raised when the required property delegated_email is not found in the config file, into credentials dictionary. | Add delegated_email property in config file, into credentials dictionary. |
17
| <input_config_credentials_key_path>.delegated_email property must be a string
| This error is raised when delegated_email is defined in the config file but the format is not str . | Edit the value of delegated_email in config file, so it is of valid str format. |
18
| <input_config_credentials_key_path>.source_id mandatory property is missing or empty
| This error is raised when the required property source_id is not found in the config file, into credentials dictionary. | Add source_id property in config file, into credentials dictionary. |
19
| <input_config_credentials_key_path}.source_id> property must be a string'
| This error is raised when source_id is defined in the config file but the format is not str . | Edit the value of source_id in config file, so it is of valid str format. |
20
| \"start_time\" property from configuration file format is invalid
| This error is raised when start_time is defined in the config file but the format is not "%Y-%m-%dT%H:%M:%S.%fZ" or "%Y-%m-%dT%H:%M:%SZ" . | Edit the value of start_time in config file, so it is of valid "%Y-%m-%dT%H:%M:%S.%fZ" or "%Y-%m-%dT%H:%M:%SZ" format. |
PrePullError
| 200
| The <state> does not meet the structure requirements of this collector version. '
f'The keys <last_alert_timestamp> and <last_alerts_id> are mandatory. State = <state>
: <error_message> | This error is raised when the |
collector is upgraded or downgraded to an incompatible version.Go back to a compatible version. Remove persistence by modifying the start_time property.
| PullError
| 300
| Puller action cannot be executed when PrePull step failed
| This error is raised when the prepull fails for whatever reason. | Check the logs to find the PrePull error. |
301
| Could not automatically determine credentials. Cause:<exception_message>. Aborting...
| This error is raised when credentials cannot be automatically determinedservice is not available. | This is an internal issue. Contact the support team. |
PullError | 304 | DefaultCredentialsError | DefaultCredentialsError | This is an internal issue. Contact the support team. |
PullError | 305 | Error detected -> {e.class}: {e.str()} | Some error occurred during the pull cycle. | This is an internal issue. Contact the support team |
.302
| The <next_timestamp> value cannot be calculated, please check the related error logs.
| This error is raised when next_timestampt cannot be calculated for the next request. | Check the logs to find the related errors