Tips for Fast Support Ticket Resolution

Get fast help from our customer support team with your enterprise license

5 Tips for Fast Resolution

  1. Generate a Support Bundle and collect troubleshooting data
  2. Open a support ticket at support.streamsets.com
  3. Provide complete details about the problem
  4. Upload all the data in the ticket (no limit on file size)
  5. Email: support@streamsets.com or call: +1 888 366 0699 when:
      • You need immediate engagement with an existing ticket
      • You open a P1 support ticket on Saturday or Sunday

Looking for Previous Software Versions?

Use your Support Portal login and go to StreamSets Data Collector and Transformer Binaries Download.
Without a Support login, please check the archives.

Details to Include in Your Ticket

  • Issue details
    • Type of issue (error message, not working as expected, performance problem, OOM issue, etc.)
    • The pipeline/job export for stage, pipeline, or job issues
    • Stack trace of the error message or the log file containing the error message
    • Is it a new pipeline/job? Does it affect only one pipeline/job or is the impact more widespread?
    • Has the issue occurred before?
    • Is the issue reproducible? What steps lead to this issue?
  • Product and version 
  • Environment type: production or non-production
  • Priority level (see Support Policy for service levels and definitions)
  • Data for troubleshooting

How to Generate Data for Troubleshooting

The more data you provide, the faster we can help solve your problem. Here are some data sources you should include:

  • Support bundle 
  • Dpm.log (if applicable)
  • Sdc.log (if not included in support bundle)
  • Plus configuration, print screens or anything else you think would be helpful

About Support Bundles

Uploading a Support Bundle to your ticket is the fastest and most complete way to securely send your data to us for troubleshooting. Support Bundle includes Data Collector logs, environment and configuration information, pipeline JSON files, resource files, and pipeline snapshots. 

  • Choose what data to share with us
  • Auto-redact all passwords entered in pipelines, configuration files, or resource files
  • Create custom rules to redact additional sensitive data, e.g. hostnames

How to Generate a Support Bundle

View Support Bundle in documentation.

  1. Request Support Bundle under Help
    Select Support Bundle from StreamSets Help Menu
  2. Click on Download to obtain the Support Bundle locally on your client machine
    Support Bundle Screenshot
  3. Upload the Support Bundle to the relevant support ticket through our Support Portal.
  4. If you have an issue with a particular pipeline, include the pipeline ID in an update in your support ticket.

What to Include for Memory Issues

When Data Collector encounters an out of memory error (OOME), it creates a heap dump. 

Heap dump files are written to the file defined in the SDC_LOG environment variable and use a naming convention with the following format: $SDC_LOG/sdc_heapdump_${timestamp}.hprof.

If a heap dump is not generated due to the memory issue or because the environmental variable is set to “false”, you will need to generate the heap dump at runtime when the SDC is experiencing the memory issue. 

Option 1: Use the following command in real time:

sudo -u sdc jcmd <pid> GC.heap_dump <filename>.hprof

Option 2: Use the old jmap command:

sudo -u sdc jmap -dump:file=<filename>.hprof <pid>

What to Include for Performance Issues

“The UI is hanging and not responding” or “The pipeline is stuck in the starting/stopping state” are examples of performance issues that require thread dumps.

A thread dump is a snapshot of threads from the moment it is generated. We recommend generating 5 thread dump files, 5 seconds apart. Multiple thread dumps in succession give us a better overview of threads that could be problematic.

You can generate a thread dump by running one of the following commands:

  • sudo -u sdc jstack -l <pid> > thread_dump.txt
  • (-F option (only if pid is unresponsive) -F Force a stack dump when ‘jstack [-l] pid’ does not respond)
  • sudo -u sdc jcmd <pid> Thread.print > thread_dump.txt
Back To Top