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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```json
{
// REQUIRED:
Expand Down
2 changes: 1 addition & 1 deletion 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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```json
// Authentication alternatives: token OR windowsPassword

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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```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-08-05T21:41:22Z */}
{/* Last updated: 2026-08-11T22:50:09Z */}
```json
{
// If non-null, enforces Perforce depot permissions.
Expand Down
73 changes: 73 additions & 0 deletions docs/self-hosted/observability/alerts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3607,6 +3607,43 @@ Generated query for critical alert: `max((max(src_repoupdater_cleanup_failed_rep

<br />

## worker: entitlements_usage_history_telemetry_queue_oldest_age

<p class="subtitle">age of the oldest unexported entitlement usage history event</p>

**Descriptions**

- <span class="badge badge-warning">warning</span> worker: 1800s+ age of the oldest unexported entitlement usage history event for 30m0s
- <span class="badge badge-critical">critical</span> worker: 7200s+ age of the oldest unexported entitlement usage history event for 2h0m0s

**Next steps**

- Check whether the entitlement usage history telemetry export job is failing or making no forward progress.
- Compare this panel with the exported events and export batch size panels above.
- Check worker logs for entitlements usage history telemetry exporter failures.
- More help interpreting this metric is available in the [dashboards reference](dashboards#worker-entitlements_usage_history_telemetry_queue_oldest_age).
- **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_worker_entitlements_usage_history_telemetry_queue_oldest_age",
"critical_worker_entitlements_usage_history_telemetry_queue_oldest_age"
]
```

<sub>*Managed by the Sourcegraph Services team.*</sub>

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

Generated query for warning alert: `max(((max(src_entitlementstelemetry_usage_history_queue_oldest_age_seconds and on (instance, job) ((increase(src_entitlementstelemetry_usage_history_queue_metrics_total{job=~"^worker.*"\}[15m]) &gt; 0) or on (instance, job) (increase(src_entitlementstelemetry_usage_history_queue_metrics_errors_total\{job=~"^worker.*"}[15m]) &gt; 0)))) or on () vector(0)) &gt; 1800)`

Generated query for critical alert: `max(((max(src_entitlementstelemetry_usage_history_queue_oldest_age_seconds and on (instance, job) ((increase(src_entitlementstelemetry_usage_history_queue_metrics_total{job=~"^worker.*"\}[15m]) &gt; 0) or on (instance, job) (increase(src_entitlementstelemetry_usage_history_queue_metrics_errors_total\{job=~"^worker.*"}[15m]) &gt; 0)))) or on () vector(0)) &gt; 7200)`

</details>

<br />

## worker: src_repoupdater_external_services_total

<p class="subtitle">the total number of external services</p>
Expand Down Expand Up @@ -6524,6 +6561,42 @@ Generated query for warning alert: `max((max by (sg_instance) (go_gc_duration_se

<br />

## codeintel-uploads: codeintel_uploads_janitor_scip_documents_oldest_dereference_log_age

<p class="subtitle">approximate age of the oldest SCIP document dereference log record, based on the lowest-ID record</p>

**Descriptions**

- <span class="badge badge-warning">warning</span> codeintel-uploads: 604800s+ approximate age of the oldest SCIP document dereference log record, based on the lowest-ID record for 15m0s

**Next steps**

- Check the SCIP documents janitor error rate and duration panels for failures or slow cleanup queries.
- Check sum(rate(src_codeintel_uploads_janitor_scip_documents_records_scanned_total[5m])). A sustained non-zero rate means the janitor is processing eligible dereference logs.
- Check sum(rate(src_codeintel_uploads_janitor_scip_documents_records_altered_total[5m])) for the document deletion rate. This may legitimately be lower than the scanned rate because referenced documents are retained.
- Check codeintel-db CPU, I/O, locks, and table growth for codeintel_scip_documents_dereference_logs.
- If cleanup is healthy but cannot keep up with the volume of generated logs, increase CODEINTEL_UPLOADS_UNREFERENCED_DOCUMENT_MAX_BATCHES.
- If increasing the batch budget is insufficient and codeintel-db has capacity, increase CODEINTEL_UPLOADS_UNREFERENCED_DOCUMENT_MAX_CONCURRENT_BATCHES.
- Learn more about the related dashboard panel in the [dashboards reference](dashboards#codeintel-uploads-codeintel_uploads_janitor_scip_documents_oldest_dereference_log_age).
- **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_codeintel-uploads_codeintel_uploads_janitor_scip_documents_oldest_dereference_log_age"
]
```

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

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

Generated query for warning alert: `max(((time() - max(src_codeintel_uploads_janitor_scip_documents_oldest_dereference_log_timestamp_seconds)) and max(src_codeintel_uploads_janitor_scip_documents_oldest_dereference_log_timestamp_seconds) &gt; 0) &gt; 604800)`

</details>

<br />

## telemetry: telemetry_gateway_exporter_queue_growth

<p class="subtitle">rate of growth of events export queue over 30m</p>
Expand Down
Loading