.. _How to Report an Issue?:

How to Report an Issue ?
========================

DVT IDE for Eclipse
-------------------

.. include:: eclipse.rst


DVT IDE for VS Code
--------------------

.. include:: vscode.rst


How to generate a thread dump for a Verissimo rule
--------------------------------------------------

There are two ways to generate thread dumps for a rule. The first one is to run **verissimo.sh** with the thread_dump arguments:

.. code-block::

  verissimo.sh -cmd my_compile.args -thread_dump_interval <milliseconds> -thread_dump_delay <milliseconds> -thread_dump_rules <rules> 
 
The second way you can do this is by including this arguments in your ruleset.xml: 

.. code-block:: xml

  <ruleset version="2" name="#RULESET_NAME#" library="#LIBRARY_NAME">
    <configuration>
      <thread-dump interval="#THREAD_DUMP_INTERVAL#" delay="#THREAD_DUMP_DELAY#" rules="#THREAD_DUMP_RULE_NAME_1#,...,#THREAD_DUMP_RULE_NAME_N" />
    </configuration>
    ...
  </ruleset>

The first thread dump is generated after the start of the rule with the specified delay. Subsequent thread dumps are generated periodically at the specified interval.
The thread dumps are generated in the "profiling" subdirectory of your project folder.


How to generate a heap histogram dump for a Verissimo rule
----------------------------------------------------------

There are two ways to generate histogram dumps for a rule. The first one is to run verissimo.sh with the histogram_dump_rules argument:

.. code-block::

  verissimo.sh -cmd my_compile.args -histogram_dump_rules <rules> 
 
The second way you can do this is by including this argument in your ruleset.xml: 

.. code-block:: xml

  <ruleset version="2" name="#RULESET_NAME#" library="#LIBRARY_NAME">
    <configuration>
      <histogram-dump rules="#HISTOGRAM_DUMP_RULE_NAME_1#,...,#HISTOGRAM_DUMP_RULE_NAME_N" />
    </configuration>
    ...
  </ruleset>

There will be two histograms generated: one when the rule starts and one when it finishes or when there is a memory warning issued, whichever happens first. The histogram dumps are generated in your project's .dvt/profiling/verissimo/ directory.