Before Reporting an Issue


Please provide as much of the information below as possible, to the best of your knowledge.

Not every question may be applicable or information readily available. However, the more details you can provide when reporting the issue, the faster and smoother the investigation and resolution process will be.

Where possible, please include configuration details, exact error messages, screenshots, logs, and steps to reproduce the issue.


1. What application is affected?

Please provide:

  • Application/product name and version

  • Operating system and version

  • Runtime and version, if applicable (Java/JDK, .NET, Python, etc.)

  • Database/client tool version, if applicable

Example:
DataGrip 2026.2.3, Windows Server 2022, bundled JDK 21.


2. How is SecuPi integrated with the application?

Please describe how SecuPi instrumentation is loaded.

Examples:

  • Java Agent (-javaagent)

  • JVM options/environment variables

  • LD_PRELOAD

  • Modified/replaced JDBC, ODBC, OCI or native driver

  • .NET profiler

  • Wrapper/BAT/shell script

  • Application-specific integration

  • Gateway (type)

Please include the relevant startup command, configuration, environment variables, or script.


3. What exactly is not working?

Please describe:

  • What you are trying to do

  • What you expect to happen

  • What actually happens

  • Exact error message, if one is displayed

Screenshots are helpful where applicable.


4. Does the problem occur without SecuPi?

If possible, test the same operation with SecuPi instrumentation disabled.

Please tell us:

With SecuPi: Does the problem occur?
Without SecuPi: Does the problem occur?

This is one of the most important troubleshooting steps.


5. Did it work previously?

If yes, please provide:

  • Last known working SecuPi version

  • Current SecuPi version

  • Any application/runtime/driver upgrade performed around the same time

  • Any configuration changes


6. What driver/library is being instrumented?

Where applicable, provide:

  • Driver/library name

  • Driver/library version

  • Full path to the library

  • Whether it is the original vendor library or a SecuPi-instrumented/replaced library

Examples include JDBC JARs, ODBC drivers, libpq, OCI libraries, .NET assemblies, etc.


7. How can the issue be reproduced?

Please provide the shortest possible sequence of steps.

For example:

  1. Start the application.

  2. Connect to the database.

  3. Run SELECT * FROM CUSTOMER.

  4. The connection fails with the attached error.

If only a specific SQL query, connection type, datasource, user, or operation causes the problem, please include that information.


8. Please provide logs

Please collect:

  • SecuPi logs covering the time of the problem

  • Application logs

  • Relevant JVM/.NET/native crash logs, if generated

  • Exact timestamp when the problem occurred

If possible, reproduce the problem once and provide logs from that specific attempt.


9. Environment details

Please indicate where the affected application is running:

  • Physical/virtual machine

  • Docker

  • Kubernetes

  • Cloud environment

  • Desktop application

For containerized environments, please also provide the image/version and relevant deployment configuration.