diff --git a/docs/admin/code-hosts/aws-codecommit.mdx b/docs/admin/code-hosts/aws-codecommit.mdx index 8eeafe2f2..e6d04614b 100644 --- a/docs/admin/code-hosts/aws-codecommit.mdx +++ b/docs/admin/code-hosts/aws-codecommit.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json { // REQUIRED: diff --git a/docs/admin/code-hosts/azuredevops.mdx b/docs/admin/code-hosts/azuredevops.mdx index 9f0b89792..d8c79ff3e 100644 --- a/docs/admin/code-hosts/azuredevops.mdx +++ b/docs/admin/code-hosts/azuredevops.mdx @@ -65,7 +65,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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json // Authentication alternatives: token OR windowsPassword diff --git a/docs/admin/code-hosts/bitbucket-cloud.mdx b/docs/admin/code-hosts/bitbucket-cloud.mdx index 50f3fc465..2a3ac188a 100644 --- a/docs/admin/code-hosts/bitbucket-cloud.mdx +++ b/docs/admin/code-hosts/bitbucket-cloud.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json { // The workspace access token to use when authenticating with Bitbucket Cloud. diff --git a/docs/admin/code-hosts/bitbucket-server.mdx b/docs/admin/code-hosts/bitbucket-server.mdx index ec9d503e1..b2948e94f 100644 --- a/docs/admin/code-hosts/bitbucket-server.mdx +++ b/docs/admin/code-hosts/bitbucket-server.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json // Authentication alternatives: token OR password diff --git a/docs/admin/code-hosts/gerrit.mdx b/docs/admin/code-hosts/gerrit.mdx index 744028860..29edc2af8 100644 --- a/docs/admin/code-hosts/gerrit.mdx +++ b/docs/admin/code-hosts/gerrit.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```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`. diff --git a/docs/admin/code-hosts/github.mdx b/docs/admin/code-hosts/github.mdx index 0306f7084..58410c437 100644 --- a/docs/admin/code-hosts/github.mdx +++ b/docs/admin/code-hosts/github.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json // Authentication alternatives: token OR gitHubAppDetails OR externalAccount OR useRandomExternalAccount diff --git a/docs/admin/code-hosts/gitlab.mdx b/docs/admin/code-hosts/gitlab.mdx index 9c64b668a..b3ca03d73 100644 --- a/docs/admin/code-hosts/gitlab.mdx +++ b/docs/admin/code-hosts/gitlab.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```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`. diff --git a/docs/admin/code-hosts/gitolite.mdx b/docs/admin/code-hosts/gitolite.mdx index 6893c03f7..6b5b6596c 100644 --- a/docs/admin/code-hosts/gitolite.mdx +++ b/docs/admin/code-hosts/gitolite.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json { // A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}). diff --git a/docs/admin/code-hosts/other.mdx b/docs/admin/code-hosts/other.mdx index ab3969727..c5b6fca01 100644 --- a/docs/admin/code-hosts/other.mdx +++ b/docs/admin/code-hosts/other.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```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.*"}). diff --git a/docs/admin/code-hosts/phabricator.mdx b/docs/admin/code-hosts/phabricator.mdx index 6dbf20838..1ceffba60 100644 --- a/docs/admin/code-hosts/phabricator.mdx +++ b/docs/admin/code-hosts/phabricator.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json { // SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`. diff --git a/docs/admin/config/settings.mdx b/docs/admin/config/settings.mdx index 44743cf16..820184ba5 100644 --- a/docs/admin/config/settings.mdx +++ b/docs/admin/config/settings.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json { @@ -41,7 +41,7 @@ Settings options and their default values are shown below. // Whether to show alerts for major and minor version updates. Alerts for patch version updates will be shown if `alerts.showPatchUpdates` is true. "alerts.showMajorMinorUpdates": true, - // Whether to show alerts for patch version updates. Alerts for major and minor version updates will be shown if `alerts.showMajorMinorUpdatess` is true. + // Whether to show alerts for patch version updates. Alerts for major and minor version updates will be shown if `alerts.showMajorMinorUpdates` is true. "alerts.showPatchUpdates": true, // Whether to run global searches over all repositories. On instances with many repositories, this can lead to issues such as: low quality results, slow response times, or significant load on the Sourcegraph instance. Defaults to true. diff --git a/docs/admin/config/site-config.mdx b/docs/admin/config/site-config.mdx index ab2cd9049..1bf3fe480 100644 --- a/docs/admin/config/site-config.mdx +++ b/docs/admin/config/site-config.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json { @@ -177,6 +177,9 @@ All site configuration options and their default values are shown below. // Disable periodically fetching git contents for existing repositories. "disableAutoGitUpdates": false, + // Disable fetching changelog posts from the external Sourcegraph changelog API. Useful for airgapped environments. + "disableChangelog": false, + // Disable the feedback survey "disableFeedbackSurvey": false, @@ -430,7 +433,7 @@ All site configuration options and their default values are shown below. "modelConfiguration": null, - // Notifications recieved from Sourcegraph.com to display in Sourcegraph. + // Notifications received from Sourcegraph.com to display in Sourcegraph. // Other example values: // - { // "key": "2023-03-10-my-key", @@ -695,7 +698,7 @@ All site configuration options and their default values are shown below. ] }, - // IP allowlist for access to the Sourcegraph instance. If set, only requests from these IP addresses will be allowed. By default client IP is infered connected client IP address, and you may configure to use a request header to determine the user IP. + // IP allowlist for access to the Sourcegraph instance. If set, only requests from these IP addresses will be allowed. By default client IP is inferred connected client IP address, and you may configure to use a request header to determine the user IP. "auth.allowedIpAddress": { "clientIpAddress": null, "enabled": false, @@ -709,7 +712,7 @@ All site configuration options and their default values are shown below. "auth.enableUsernameChanges": false, // Enables OAuth 2.0 Dynamic Client Registration (RFC 7591) for the Sourcegraph identity provider. When enabled, OAuth clients can self-register programmatically instead of requiring manual pre-configuration. Required for MCP clients and other applications that use dynamic registration for authorization. - "auth.idpDynamicClientRegistrationEnabled": false, + "auth.idpDynamicClientRegistrationEnabled": true, // The config options for account lockout // Other example values: @@ -762,7 +765,7 @@ All site configuration options and their default values are shown below. ], // The maximum duration of a user session, after which it expires and the user is required to re-authenticate. The default is 90 days. Must be at least 1 hour. There is typically no need to set this, but some users may have specific internal security requirements. - // The string format is that of the Duration type in the Go time package (https://golang.org/pkg/time/#ParseDuration). E.g., "720h", "43200m", "2592000s" all indicate a timespan of 30 days. + // The string format is that of the Duration type in the Go time package (https://golang.org/pkg/time/#ParseDuration). E.g., "720h", "43200m", "2592000s" all indicate a time span of 30 days. // Other example values: // - "168h" "auth.sessionExpiry": "2160h", @@ -779,7 +782,7 @@ All site configuration options and their default values are shown below. // Other example values: // - { // "*": [ - // "myorg1" + // "org1" // ] // } "auth.userOrgMap": null, @@ -831,7 +834,6 @@ All site configuration options and their default values are shown below. // "accessToken": "abc123", // "chatModel": "chat", // "completionModel": "code-completion", - // "enabled": true, // "perUserDailyLimit": 100, // "provider": "openai" // } @@ -952,7 +954,7 @@ All site configuration options and their default values are shown below. // Maximum number of git clone processes that will be run concurrently per gitserver to update repositories. <= 0 means disabled. "gitMaxConcurrentCleanups": 5, - // Maximum number of git clone processes that will be run concurrently per gitserver to update repositories. Note: the global git update scheduler respects gitMaxConcurrentClones. However, we allow each gitserver to run upto gitMaxConcurrentClones to allow for urgent fetches. Urgent fetches are used when a user is browsing a PR and we do not have the commit yet. + // Maximum number of git clone processes that will be run concurrently per gitserver to update repositories. Note: the global git update scheduler respects gitMaxConcurrentClones. However, we allow each gitserver to run up to gitMaxConcurrentClones to allow for urgent fetches. Urgent fetches are used when a user is browsing a PR and we do not have the commit yet. "gitMaxConcurrentClones": 5, // Record git operations that are executed on configured repositories. @@ -1013,7 +1015,6 @@ All site configuration options and their default values are shown below. // "logo": "https://example.com/logo_dark.png", // "symbol": "https://example.com/search_symbol_dark_24x24.png" // }, - // "disableSymbolSpin": true, // "favicon": "https://example.com/favicon.ico", // "light": { // "logo": "https://example.com/logo_light.png", diff --git a/docs/admin/repo/perforce.mdx b/docs/admin/repo/perforce.mdx index 7051f22be..3fb01087d 100644 --- a/docs/admin/repo/perforce.mdx +++ b/docs/admin/repo/perforce.mdx @@ -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-01-22T04:55:03Z */} +{/* Last updated: 2026-01-29T07:18:06Z */} ```json { // If non-null, enforces Perforce depot permissions. diff --git a/docs/self-hosted/observability/alerts.mdx b/docs/self-hosted/observability/alerts.mdx index 6236c6e32..b43a012d1 100644 --- a/docs/self-hosted/observability/alerts.mdx +++ b/docs/self-hosted/observability/alerts.mdx @@ -6835,6 +6835,111 @@ Generated query for critical alert: `min((sum by (app) (up{app=~".*otel-collecto
+## deepsearch: deepsearch_questions_in_flight_growth + +

rate of growth of in-flight questions over 1h

+ +**Descriptions** + +- warning deepsearch: 1+ rate of growth of in-flight questions over 1h for 30m0s +- critical deepsearch: 1+ rate of growth of in-flight questions over 1h for 1h0m0s + +**Next steps** + +- Check for questions that are never stopping. +- Check for slow LLM responses or tool execution times. +- Review `deepsearch_question_processing_duration` for processing time trends. +- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_questions_in_flight_growth). +- **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_questions_in_flight_growth", + "critical_deepsearch_deepsearch_questions_in_flight_growth" +] +``` + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Generated query for warning alert: `max((max(deriv(src_deepsearch_questions_in_flight[1h]))) > 1)` + +Generated query for critical alert: `max((max(deriv(src_deepsearch_questions_in_flight[1h]))) > 1)` + +
+ +
+ +## deepsearch: deepsearch_question_processing_error_rate + +

question processing error rate over 5m

+ +**Descriptions** + +- warning deepsearch: 10%+ question processing error rate over 5m for 10m0s +- critical deepsearch: 20%+ question processing error rate over 5m for 10m0s + +**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: + +```json +"observability.silenceAlerts": [ + "warning_deepsearch_deepsearch_question_processing_error_rate", + "critical_deepsearch_deepsearch_question_processing_error_rate" +] +``` + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Generated query for warning alert: `max((sum(rate(src_deepsearch_question_processing_errors_total{operation="question"\}[5m])) / (sum(rate(src_deepsearch_question_processing_total\{operation="question"}[5m])) > 0) * 100) > 10)` + +Generated query for critical alert: `max((sum(rate(src_deepsearch_question_processing_errors_total{operation="question"\}[5m])) / (sum(rate(src_deepsearch_question_processing_total\{operation="question"}[5m])) > 0) * 100) > 20)` + +
+ +
+ +## deepsearch: deepsearch_llm_stream_fatal_errors + +

fatal LLM stream errors over 5m

+ +**Descriptions** + +- warning deepsearch: 20+ fatal LLM stream errors over 5m + +**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). +- **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" +] +``` + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Generated query for warning alert: `max((sum(increase(src_deepsearch_question_processing_errors_total{operation="llm_stream_fatal"}[5m]))) > 20)` + +
+ +
+ ## background-jobs: error_percentage_by_method

percentage of operations resulting in error by method

diff --git a/docs/self-hosted/observability/dashboards.mdx b/docs/self-hosted/observability/dashboards.mdx index a99cad066..9630beb0e 100644 --- a/docs/self-hosted/observability/dashboards.mdx +++ b/docs/self-hosted/observability/dashboards.mdx @@ -34943,6 +34943,208 @@ histogram_quantile(0.50, sum(rate(src_completions_upstream_connection_dial_durat
+## Deep Search + +

Monitoring for Deep Search question processing.

+ +To see this dashboard, visit `/-/debug/grafana/d/deepsearch/deepsearch` on your Sourcegraph instance. + +### Deep Search: Question processing + +#### deepsearch: deepsearch_questions_in_flight + +

Number of questions currently being processed

+ +The number of deep search questions currently being processed. + +This panel has no related alerts. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100000` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +sum(src_deepsearch_questions_in_flight) +``` +
+ +
+ +#### deepsearch: deepsearch_questions_in_flight_growth + +

Rate of growth of in-flight questions over 1h

+ +A positive value indicates the queue is growing faster than it`s being processed. + +Refer to the [alerts reference](alerts#deepsearch-deepsearch_questions_in_flight_growth) for 2 alerts related to this panel. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100001` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +max(deriv(src_deepsearch_questions_in_flight[1h])) +``` +
+ +
+ +#### deepsearch: deepsearch_question_processing_rate + +

Questions processed per minute

+ +Rate of deep search questions being processed. + +This panel has no related alerts. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100010` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +sum(rate(src_deepsearch_question_processing_total{operation="question"}[5m])) * 60 +``` +
+ +
+ +#### deepsearch: deepsearch_question_processing_error_rate + +

Question processing error rate over 5m

+ +Percentage of deep search questions that result in an error. + +Refer to the [alerts reference](alerts#deepsearch-deepsearch_question_processing_error_rate) for 2 alerts related to this panel. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100011` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +sum(rate(src_deepsearch_question_processing_errors_total{operation="question"}[5m])) / (sum(rate(src_deepsearch_question_processing_total{operation="question"}[5m])) > 0) * 100 +``` +
+ +
+ +#### deepsearch: deepsearch_question_processing_p99_duration + +

99th percentile question processing duration

+ +99th percentile time to process a deep search question. + +This panel has no related alerts. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100020` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +histogram_quantile(0.99, sum(rate(src_deepsearch_question_processing_duration_seconds_bucket{operation="question"}[5m])) by (le)) +``` +
+ +
+ +#### deepsearch: deepsearch_question_processing_p50_duration + +

50th percentile question processing duration

+ +Median time to process a deep search question. + +This panel has no related alerts. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100021` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +histogram_quantile(0.50, sum(rate(src_deepsearch_question_processing_duration_seconds_bucket{operation="question"}[5m])) by (le)) +``` +
+ +
+ +### Deep Search: LLM streaming + +#### deepsearch: deepsearch_llm_stream_fatal_errors + +

Fatal LLM stream errors over 5m

+ +Number of fatal errors during LLM streaming in the last 5 minutes. + +Refer to the [alerts reference](alerts#deepsearch-deepsearch_llm_stream_fatal_errors) for 1 alert related to this panel. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100100` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +sum(increase(src_deepsearch_question_processing_errors_total{operation="llm_stream_fatal"}[5m])) +``` +
+ +
+ +#### deepsearch: deepsearch_llm_stream_non_fatal_errors + +

Non-fatal LLM stream errors over 5m

+ +Number of non-fatal errors during LLM streaming. + +This panel has no related alerts. + +To see this panel, visit `/-/debug/grafana/d/deepsearch/deepsearch?viewPanel=100101` on your Sourcegraph instance. + +*Managed by the Sourcegraph Code Understanding team.* + +
+Technical details + +Query: + +``` +sum(increase(src_deepsearch_question_processing_errors_total{operation="llm_stream_non_fatal"}[5m])) +``` +
+ +
+ ## Periodic Goroutines

Overview of all periodic background routines across Sourcegraph services.