Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/aws-codecommit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ AWS CodeCommit connections support the following configuration options, which ar

{/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// REQUIRED:
Expand Down
20 changes: 12 additions & 8 deletions docs/admin/code-hosts/azuredevops.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Azure DevOps connections support the following configuration options, which are

{/* SCHEMA_SYNC_START: admin/code_hosts/azuredevops.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
// Authentication alternatives: token OR windowsPassword

Expand Down Expand Up @@ -131,19 +131,23 @@ Azure DevOps connections support the following configuration options, which are
// ]
"projects": null,

// An array of "org/project/repo" strings specifying which Azure DevOps repositories within a project should be mirrored in Sourcegraph.
"repos": [
"myorg/my-project/myrepo", // Format: <organization>/<project>/<repository>
"myorg/myproject/myproject", // Format: repository where project and repo share the same name
"myorg/my project/my project" // Format: spaces in project or repository names
]

// Rate limit applied when making background API requests.
"rateLimit": {
"enabled": false,
"requestsPerHour": 0
},

// An array of repository "org/project/repo" strings specifying which Azure DevOps repositories to mirror on Sourcegraph. If both 'repos' and 'projects' or 'orgs' are specified, the union of both sets will be synced.
// Other example values:
// - [
// "myorg/myproject/myrepo"
// ]
// - [
// "myorg/my project/myrepo",
// "myorg/anotherproject/anotherrepo"
// ]
"repos": null,

// The pattern used to generate the corresponding Sourcegraph repository name for a Azure DevOps repository.
// - "{host}" is replaced with the Azure DevOps URL's host (such as dev.azure.com)
// - "{orgName}" is replaced with the repository's parent projects owning organization (or collection on DevOps server)
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/bitbucket-cloud.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ Bitbucket Cloud connections support the following configuration options, which a

{/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// The workspace access token to use when authenticating with Bitbucket Cloud.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/bitbucket-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ Bitbucket Server / Bitbucket Data Center connections support the following confi

{/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_server.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
// Authentication alternatives: token OR password

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/gerrit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ Gerrit connections support the following configuration options, which are specif

{/* SCHEMA_SYNC_START: admin/code_hosts/gerrit.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// If non-null, enforces Gerrit repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "gerrit" with the same `url` field as specified in this `GerritConnection`.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/github.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -454,7 +454,7 @@ GitHub connections support the following configuration options, which are specif

{/* SCHEMA_SYNC_START: admin/code_hosts/github.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
// Authentication alternatives: token OR gitHubAppDetails OR externalAccount OR useRandomExternalAccount

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/gitlab.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits).

{/* SCHEMA_SYNC_START: admin/code_hosts/gitlab.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// If non-null, enforces GitLab repository permissions. This requires that there be an item in the `auth.providers` field of type "gitlab" with the same `url` field as specified in this `GitLabConnection`.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/gitolite.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ To connect Gitolite to Sourcegraph:

{/* SCHEMA_SYNC_START: admin/code_hosts/gitolite.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}).
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/other.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Repositories must be listed individually:

{/* SCHEMA_SYNC_START: admin/code_hosts/other_external_service.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// A list of repositories to never mirror by name after applying repositoryPathPattern. Supports excluding by exact name ({"name": "myrepo"}) or regular expression ({"pattern": ".*secret.*"}).
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/phabricator.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ The Sourcegraph instance's site admin must [update the `corsOrigin` site config

{/* SCHEMA_SYNC_START: admin/code_hosts/phabricator.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/config/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Settings options and their default values are shown below.

{/* SCHEMA_SYNC_START: admin/config/settings.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/config/site-config.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ All site configuration options and their default values are shown below.

{/* SCHEMA_SYNC_START: admin/config/site.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/repo/perforce.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -228,7 +228,7 @@ With this setting, Sourcegraph will ignore any rules with a host other than `*`,

{/* SCHEMA_SYNC_START: admin/code_hosts/perforce.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-03-30T11:57:12Z */}
{/* Last updated: 2026-04-10T22:24:46Z */}
```json
{
// If non-null, enforces Perforce depot permissions.
Expand Down
22 changes: 22 additions & 0 deletions docs/cli/references/auth.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# `src auth`



## Usage

```
'src auth' provides authentication-related helper commands.

Usage:

src auth command [command options]

The commands are:

token prints the current authentication token

Use "src auth [command] -h" for more information about a command.


```

1 change: 1 addition & 0 deletions docs/cli/references/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@

* [`admin`](references/admin)
* [`api`](references/api)
* [`auth`](references/auth)
* [`batch`](references/batch)
* [`code-intel`](references/code-intel)
* [`codeowners`](references/codeowners)
Expand Down
6 changes: 5 additions & 1 deletion docs/cli/references/login.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@

Usage:

src login SOURCEGRAPH_URL
src login [flags] SOURCEGRAPH_URL

Examples:

Expand All @@ -31,6 +31,10 @@ Examples:

$ src login https://sourcegraph.com

If no access token is configured, 'src login' uses OAuth device flow automatically:

$ src login https://sourcegraph.com

-dump-requests
Log GraphQL requests and responses to stdout
-get-curl
Expand Down
58 changes: 50 additions & 8 deletions docs/self-hosted/observability/alerts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6815,7 +6815,6 @@ Generated query for critical alert: `max((max(deriv(src_deepsearch_questions_in_
**Next steps**

- Check frontend logs for `Worker failed to process question` errors.
- Review LLM stream errors in the `LLM streaming` panel below.
- Check for upstream LLM provider issues.
- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_question_processing_error_rate).
- **Silence this alert:** If you are aware of this alert and want to silence notifications for it, add the following to your site configuration and set a reminder to re-evaluate the alert:
Expand All @@ -6840,23 +6839,27 @@ Generated query for critical alert: `max((sum(rate(src_deepsearch_question_proce

<br />

## deepsearch: deepsearch_llm_stream_fatal_errors
## deepsearch: deepsearch_slow_questions

<p class="subtitle">fatal LLM stream errors over 5m</p>
<p class="subtitle">questions taking longer than 5 minutes over 15m</p>

**Descriptions**

- <span class="badge badge-warning">warning</span> deepsearch: 20+ fatal LLM stream errors over 5m
- <span class="badge badge-warning">warning</span> deepsearch: 3+ questions taking longer than 5 minutes over 15m
- <span class="badge badge-critical">critical</span> deepsearch: 10+ questions taking longer than 5 minutes over 15m

**Next steps**

- Check frontend logs for `fatal error in LLM stream`.
- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_llm_stream_fatal_errors).
- Search frontend logs for questionIDs with long processing times.
- Check `deepsearch_turn_p95_duration` to see if individual turns are slow.
- Check `deepsearch_question_outcome_by_reason` for elevated truncation or error rates.
- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_slow_questions).
- **Silence this alert:** If you are aware of this alert and want to silence notifications for it, add the following to your site configuration and set a reminder to re-evaluate the alert:

```json
"observability.silenceAlerts": [
"warning_deepsearch_deepsearch_llm_stream_fatal_errors"
"warning_deepsearch_deepsearch_slow_questions",
"critical_deepsearch_deepsearch_slow_questions"
]
```

Expand All @@ -6865,7 +6868,46 @@ Generated query for critical alert: `max((sum(rate(src_deepsearch_question_proce
<details>
<summary>Technical details</summary>

Generated query for warning alert: `max((sum(increase(src_deepsearch_question_processing_errors_total{operation="llm_stream_fatal"}[5m]))) &gt; 20)`
Generated query for warning alert: `max((sum(increase(src_deepsearch_question_processing_duration_seconds_count{operation="question"\}[15m])) - sum(increase(src_deepsearch_question_processing_duration_seconds_bucket\{le="300",operation="question"}[15m]))) &gt; 3)`

Generated query for critical alert: `max((sum(increase(src_deepsearch_question_processing_duration_seconds_count{operation="question"\}[15m])) - sum(increase(src_deepsearch_question_processing_duration_seconds_bucket\{le="300",operation="question"}[15m]))) &gt; 10)`

</details>

<br />

## deepsearch: deepsearch_response_truncated

<p class="subtitle">response truncated questions over 15m</p>

**Descriptions**

- <span class="badge badge-warning">warning</span> deepsearch: 3+ response truncated questions over 15m
- <span class="badge badge-critical">critical</span> deepsearch: 10+ response truncated questions over 15m

**Next steps**

- Search frontend logs for: "answer truncated due to output token limit" to find affected questionIDs.
- This usually indicates model overthinking and spending all output tokens on thinking with no useful answer, or the user requested an extremely large output.
- Check if a recent model change may have caused increased thinking token usage.
- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_response_truncated).
- **Silence this alert:** If you are aware of this alert and want to silence notifications for it, add the following to your site configuration and set a reminder to re-evaluate the alert:

```json
"observability.silenceAlerts": [
"warning_deepsearch_deepsearch_response_truncated",
"critical_deepsearch_deepsearch_response_truncated"
]
```

<sub>*Managed by the Sourcegraph Code Understanding team.*</sub>

<details>
<summary>Technical details</summary>

Generated query for warning alert: `max((sum(increase(src_deepsearch_question_outcome_total{outcome="response_truncated"}[15m]))) &gt; 3)`

Generated query for critical alert: `max((sum(increase(src_deepsearch_question_outcome_total{outcome="response_truncated"}[15m]))) &gt; 10)`

</details>

Expand Down
Loading