Skip to content

Commit cf6bf7f

Browse files
authored
update with SQL LogScout info
1 parent a6a0bbb commit cf6bf7f

1 file changed

Lines changed: 23 additions & 2 deletions

File tree

support/sql/database-engine/availability-groups/use-agdiag-diagnose-availability-group-health-events.md

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,30 @@ ms.reviewer: cmathews, v-sidong
1212
1313
AGDiag is an application that automates the manual analysis described in the article (mentioned in the **Note** section). It analyzes the cluster log and correlates and reports pertinent events from the other logs (SQL Server error logs, Windows event logs, and so on). It generates a summary report of Windows Cluster and Always On health events and then provides more detailed analysis results for each health event detected. It automates much of the work described in the article (mentioned in the **Note** section) when the proper logs are provided from the availability group primary replica at the time of the health event.
1414

15-
## Use TSS to generate logs for AGDiag to diagnose
15+
## Generate logs for AGDiag to diagnose
1616

17-
To diagnose an availability group health event, use the TSS to collect logs on the SQL Server instance that was in the primary role at the time of the event.
17+
You can use multiple methods to generate the logs that AGDiag uses as inputs. Besides the manual collection of Windows Cluster Diagnostic Logs, SQL Server Error Logs, Windows System Event Logs, System Health Extended Events (XEL) and AlwaysOn Health Session XEL Files, you can use either of two log collection tools to capture those.
18+
19+
Use one of these log collection tools:
20+
21+
### Use SQL LogScout to capture logs for AGDiag analysis
22+
23+
To diagnose an availability group health event, use the SQL LogScout to collect logs on the SQL Server instance that was in the primary role at the time of the event.
24+
25+
1. Download the latest [SQL LogScout](http://aka.ms/get-sqllogscout) as zip file.
26+
1. Save and extract the zip file in a folder on the machine where SQL Server hosts the primary replica when the failover started or the availability group was resolving.
27+
1. Open an elevated PowerShell command (Run as Administrator), change the directory to the SQL LogScout folder where the zip file was extracted
28+
1. Run the following command to capture the `Basic` scenario and follow the prompts
29+
30+
```PowerShell
31+
.\SQL_LogScout.ps1 -Scenario "Basic" -ServerName "<your_sql_instance_name>"
32+
```
33+
34+
1. Once the process of log capturing is complete, you can poing AGDiag to the **\output** folder where SQL LogScout collected the logs.
35+
36+
### Use TSS to generate logs for AGDiag to diagnose
37+
38+
Alternatively, to capture the logs you can use the TSS on the SQL Server instance that was in the primary role at the time of the event.
1839

1940
Follow these steps to accomplish this goal:
2041

0 commit comments

Comments
 (0)