Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update troubleshooting to include OLE DB 2019 #20824

Merged
merged 3 commits into from
Nov 29, 2023
Merged

Update troubleshooting to include OLE DB 2019 #20824

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b29e6b9
Update troubleshooting to include OLE DB 2019
jhgilbert Nov 28, 2023
22ec421
Incorporate feedback
jhgilbert Nov 28, 2023
ce3732f
Revise content for clarity
jhgilbert Nov 29, 2023
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
18 changes: 11 additions & 7 deletions content/en/database_monitoring/setup_sql_server/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,15 +114,17 @@

### SSL Provider: The certificate chain was issued by an authority that is not trusted {#certificate-verify-fail}

This error is common after upgrading to the latest [MSOLEDBSQL][6] driver due to [breaking changes][7] that were introduced. In the latest version of the driver, all connections to the SQL instance are encrypted by default.
#### Microsoft OLE DB Driver 2019

Check warning on line 117 in content/en/database_monitoring/setup_sql_server/troubleshooting.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/en/database_monitoring/setup_sql_server/troubleshooting.md#L117 

[Datadog.headings] 'Microsoft OLE DB Driver 2019' should use sentence-style capitalization.
Raw output 
{"message": "[Datadog.headings] 'Microsoft OLE DB Driver 2019' should use sentence-style capitalization.", "location": {"path": "content/en/database_monitoring/setup_sql_server/troubleshooting.md", "range": {"start": {"line": 117, "column": 6}}}, "severity": "WARNING"}

If you are using the latest version of the Microsoft OLE DB Driver for SQL Server, and trying to connect to a SQL Server instance which requires encrypted connections, you can use the following workarounds:
This error is common after upgrading to the [`MSOLEDBSQL` 2019][6] driver due to [breaking changes][7] that were introduced. In the latest version of the driver, all connections to the SQL instance are encrypted by default.

If you are using the latest version of the Microsoft OLE DB Driver for SQL Server, and trying to connect to a SQL Server instance which requires encrypted connections, you can use one of the following workarounds:

Check notice on line 121 in content/en/database_monitoring/setup_sql_server/troubleshooting.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/en/database_monitoring/setup_sql_server/troubleshooting.md#L121 

[Datadog.sentencelength] Try to keep your sentence length to 25 words or fewer.
Raw output 
{"message": "[Datadog.sentencelength] Try to keep your sentence length to 25 words or fewer.", "location": {"path": "content/en/database_monitoring/setup_sql_server/troubleshooting.md", "range": {"start": {"line": 121, "column": 1}}}, "severity": "INFO"}

1. If you are using a self-signed certificate and the Force Encryption setting on the server (`rds.force_ssl=1` on AWS) to ensure clients connect with encryption:

- Change to a certificate that is trusted as part of the client's trust chain
- Add the self-signed certificate as a trusted certificate on the client
- Add `TrustServerCertificate=yes;` to the connection string
- Change to a certificate that is trusted as part of the client's trust chain.
- Add the self-signed certificate as a trusted certificate on the client.
- Add `Trust Server Certificate=True;` to the connection string.

This is described in more detail [in the Microsoft documentation][7]

Expand All @@ -132,7 +134,7 @@
# example uses windows authentication
instances:
- host: <INSTANCE_ENDPOINT>,<PORT>
connection_string: "Trusted_Connection=yes;Use Encryption for Data=False;"
connection_string: "Trust Server Certificate=True;Use Encryption for Data=False;"
connector: adodbapi
adoprovider: MSOLEDBSQL19
```
Expand All @@ -148,7 +150,9 @@
adoprovider: MSOLEDBSQL
```

If you are using a driver **other than `MSOLEDBSQL` 2019**, this error can be resolved by setting `TrustServerCertificate=yes` in the connection string. For example, for the 2017 `ODBC` driver:
#### Other Microsoft OLE DB Driver versions

Check warning on line 153 in content/en/database_monitoring/setup_sql_server/troubleshooting.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/en/database_monitoring/setup_sql_server/troubleshooting.md#L153 

[Datadog.headings] 'Other Microsoft OLE DB Driver versions' should use sentence-style capitalization.
Raw output 
{"message": "[Datadog.headings] 'Other Microsoft OLE DB Driver versions' should use sentence-style capitalization.", "location": {"path": "content/en/database_monitoring/setup_sql_server/troubleshooting.md", "range": {"start": {"line": 153, "column": 6}}}, "severity": "WARNING"}

If you are using a driver other than `MSOLEDBSQL` 2019, this error can be resolved by setting `TrustServerCertificate=yes` in the connection string. For example, for the 2017 `ODBC` driver:

```yaml
# this example uses SQL Server authentication
Expand Down
Loading