Skip to content

Commit

Permalink
Document Studio error: Failed to push experiment (#2933)
Browse files Browse the repository at this point in the history
* Fix markdown lints for Studio troubleshooting docs

Also introduce a couple of word break opportunity tags [1] to split the
long string `metrics/hyperparameters/files` over multiple lines so the
content flows a little better in some cases.

 [1]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/wbr

* Document experiment error about failed pushes
  • Loading branch information
duijf authored Oct 18, 2021
1 parent b0c1e2f commit c567ef0
Showing 1 changed file with 30 additions and 6 deletions.
36 changes: 30 additions & 6 deletions content/docs/studio/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ DVC Studio.
- [View got created, but does not contain any data](#view-got-created-but-does-not-contain-any-data)
- [View does not contain the columns that I want](#view-does-not-contain-the-columns-that-i-want)
- [View contains columns that I did not import](#view-contains-columns-that-i-did-not-import)
- [Error: Failed to push experiment to repository](#error-failed-to-push-experiment-to-repository)

## Support

If you need further help, please send us a message using `Help` on the
[project website](https://studio.iterative.ai). You can also create a support
Expand Down Expand Up @@ -108,12 +111,12 @@ There are two possible reasons for this:
DVC Studio will also import the unselected columns, but only up to a maximum
of 200 columns.

**What if there are more than 200 mandatory columns?**
Currently DVC Studio cannot import over 200 columns. If you have a large
repository (with more than 200 mandatory columns), one solution is to split
the metrics/hyperparameters/files that you want to display over multiple
subdirectories in your git repository. For each subdirectory, you can create
a new view that is limited to that subdirectory.
**What if there are more than 200 mandatory columns?** Currently DVC Studio
cannot import over 200 columns. If you have a large repository (with more
than 200 mandatory columns), one solution is to split the
metrics/<wbr>hyperparameters/<wbr>files that you want to display over
multiple subdirectories in your git repository. For each subdirectory, you
can create a new view that is limited to that subdirectory.

To create views for subdirectories,
[specify the project directory in view settings](/doc/studio/user-guide/views/view-settings#project-directory).
Expand Down Expand Up @@ -143,3 +146,24 @@ If you would like to explicitly hide columns, you can simply hide them in the
view. Once you show/hide columns, you can save the changes. Check out the
[above video](#showhide-columns) to see how you can show/hide columns. Once you
show/hide columns, remember to save the changes.

## Error: Failed to push experiment to repository

This is a non-specific error with a range of possible causes. To resolve it,
please check:

- Your account is able to push to the repository.
- The repository is **not** marked as archived / read only.
- In case of GitHub/GitLab/BitBucket enterprise organizations: there is no IP
whitelisting policy in place which limits access to the organization's
resources.
- Whether [GitHub][gh-status], [GitLab][gl-status], or [BitBucket][bb-status]
are experiencing service disruptions. In case of an on-prem deployment, please
check with your administrator.

[gh-status]: https://www.githubstatus.com/
[gl-status]: https://status.gitlab.com/
[bb-status]: https://bitbucket.status.atlassian.com/

If you get this error and none of the above applies, please
[get in touch with us](#support).

0 comments on commit c567ef0

Please sign in to comment.