Troubleshooting↑

Logging↑

The AQG_LOG environment variable allows you to configure logging settings. By default, the logging level is set to info.

Set the logging level↑

Use the following command to log only error messages:

Bash

$ AQG_LOG=error yanadump

This command sets the log level for yanadump to debug while other modules retain the default info:

Bash

$ AQG_LOG=info,yanadump=debug yanadump

For more detailed information about using the environment variable, refer to the env_logger documentation.

Memory errors↑

Depending on the system configuration, errors related to the ring buffer memory can ben encountered on Linux, eg.:

Text Only

ERROR yana::driver::live::rx_ring: Too much memory has been locked. Consider increasing the locked-in-memory limit with the following command-line `ulimit -S -l 4096`.
ERROR yanadump: Error while running: Failed to mmap ring buffer: Resource temporarily unavailable (os error 11)

The limit of memory that can be locked can be increased with the ulimit command, and should be set before running yanadump. The following command sets the limit to 4096KB:

Bash

$ ulimit -S -l 4096

If yanadump is ran within a container, the --ulimit argument can be given to docker to set the memory lock limit to an appropriate value (in bytes):

Bash

docker run --ulimit memlock=4194304:4194304

Problem: Self-signed certificate verification failure↑

Self-signed certificates must have a valid Subject Alternative Name and a Basic Constraint extension with the CA value set to FALSE in order to be accepted.

The following OpenSSL command line example generates a self-signed certificate for localhost:

Bash

$ openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 3650 -nodes -subj '/CN=localhost' -addext 'basicConstraints=CA:FALSE' -addext 'subjectAltName=DNS:localhost'