Eclipse troubleshooting

{{< details >}}

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
  • Status: Beta

{{< /details >}}

{{< history >}}

  • Changed from experiment to beta in GitLab 17.11.

{{< /history >}}

{{< alert type=”disclaimer” />}}

If the steps on this page don’t solve your problem, check the list of open issues in the Eclipse plugin’s project. If an issue matches your problem, update the issue. If no issues match your problem, create a new issue with the required information for support.

Review the Error Log

  1. In the menu bar of your IDE, select Window.
  2. Expand Show View, then select Error Log.
  3. Search for errors referencing the gitlab-eclipse-plugin plugins.

Locate the Workspace Log file

The Workspace log file, named .log is located in the directory <your-eclipse-workspace>/.metadata.

Enable GitLab Language Server debug logs

To enable GitLab Language Server debug logs:

  1. In your IDE, select Eclipse > Settings.
  2. On the left sidebar, select GitLab.
  3. In Language Server Log Level, enter debug.
  4. Select Apply and Close.

The debug logs are available in the language_server.log file. To view this file, either:

  • Go to the directory /Users/<user>/eclipse/<eclipse-version>/Eclipse.app/Contents/MacOS/.gitlab_plugin, replacing <user> and <eclipse-version> with the appropriate values.
  • Open the Error logs. Search for the log Language server logs saved to: <file>. where <file> is the absolute path to the language_server.log file.

Required information for support

When creating a support request, provide the following information:

  1. Your current GitLab for Eclipse plugin version.
    1. Open the About Eclipse IDE dialog.
      • On Windows, in your IDE, select Help > About Eclipse IDE.
      • On MacOS, in your IDE, select Eclipse > About Eclipse IDE.
    2. On the dialog, select Installation details.
    3. Locate GitLab for Eclipse and copy the Version value.
  2. Your Eclipse version.
    1. Open the About Eclipse IDE dialog.
      • On Windows, in your IDE, select Help > About Eclipse IDE.
      • On MacOS, in your IDE, select Eclipse > About Eclipse IDE.
  3. Your operating system.
  4. Are you using a GitLab.com, GitLab Self-Managed, or GitLab Dedicated instance?
  5. Are you using a proxy?
  6. Are you using a self-signed certificate?
  7. The workspace logs.
  8. The Language Server debug logs.
  9. If applicable, a video or a screenshot of the issue.
  10. If applicable, the steps to reproduce the issue.
  11. If applicable, the attempted steps to resolve the issue.

Certificate errors

{{< alert type=”warning” >}}

You may experience errors connecting to GitLab if you connect to GitLab through a proxy or using custom certificates. Support for HTTP proxies and support for custom certificates are proposed for a future release.

{{< /alert >}}