How to Report Issues in Arvados » History » Version 1

Version 1/7 - Next » - Current version
Brett Smith, 09/18/2014 09:30 AM
first draft, not final


How to Report Issues in Arvados

If you encounter a problem using Arvados, the surest way to make sure it gets fixed is to report an issue on our bug tracker. The best bug reports include:

  • all the steps you took that led to the issue,
  • the action Arvados took, including the full text of any error messages it reported, and
  • the action you expected Arvados to take (even if that's as simple as "it shouldn't crash").

Some issues are limited to specific data in Arvados—for example, maybe you're having trouble accessing a particular collection. When you file issues like this, please only include UUIDs for jobs, pipeline instances, and pipeline templates. Other identifiers, like Collection UUIDs or Keep block locators, can potentially reveal details about your work to the public. If you're having trouble with sensitive data, please refer to it through data that's safe to talk about—for example, "the input parameter of pipeline instance P," or "the output of job J." If you're including a large error message like a backtrace from a command-line tool, please take care to edit out any sensitive identifiers in it.

If you must report an issue that includes sensitive information, please send it by e-mail to . Thanks for helping us improve Arvados!