Einfach mal Druck machen. PDF-Erzeugung in Oracle ...
Sandkastenspiele 2.0*: MySQL Testumgebungen mit de...
3 Minuten Lesezeit (593 Worte)

Ergebnisse von sp_Blitz im Markdown Format

Die Prozedur sp_Blitz aus dem First Responder Kit von Brent Ozar überprüft die Konfiguration und den Zustand von Microsoft-SQL-Servern und listet die gefundenen Auffälligkeiten in einer Tabelle auf. Wir nutzen diese Prozedur sehr gerne beim ersten Kontakt mit neuen Kunden, um einen schnellen Überblick über die SQL Server zu erhalten.

Im Jahr 2022 habe ich von der Möglichkeit erfahren, die Ergebnisse im Markdown-Format auszugeben. Diese möchte ich hier vorstellen, denn sie bietet Vorteile – hat aber leider auch Nachteile.

Die Vorteile

In den meisten Fällen führt der Kunde die Prozedur im SQL Server Management Studio (SSMS) aus und kopiert das Ergebnis in eine Excel-Tabelle. Über den Parameter @OutputType kann die Ausgabe aber auch in anderen Formaten ausgegeben werden, darunter auch als Aufzählungsliste im Markdown Format. So ist das Ergebnis einfach mal schnell in eine Mail kopiert, denn auch ohne Markdown-Editor ist eine Aufzählungsliste sehr gut zu lesen.

Wir können dann sehr einfach weitere Informationen in dieser Liste ergänzen und die Liste für den Kunden aufbereiten, um im Anschluss die für den Kunden relevanten Probleme gemeinsam anzugehen. Auch zur Ablage in der Dokumentation eignet sich eine Aufzählungsliste in vielen Fällen besser als eine Tabelle.

Die Funktionsweise

Aber Achtung: Leider verrät nur ein Blick in den Quellcode die genaue Funktionsweise, da nur eine knappe Dokumentation im Quellcode vorhanden ist. Denn bei @OutputType = 'markdown' passiert Folgendes:

Der Parameter @CheckProcedureCache wird auf 0 gesetzt, was aber auch der Standardwert für diesen Parameter ist (Quellcode).

Der Parameter @CheckServerInfo wird auf 1 gesetzt, wodurch zusätzliche Informationen wie die verwendete Version oder die Hardware-Ausstattung ausgegeben werden (Quellcode).

Die Ausgabe enthält jedoch keine Informationen über Sicherheitsaspekte. Das wurde eingeführt, da diese Funktionalität ursprünglich zum schnellen Teilen von Informationen über einen öffentlichen Kanal bei Slack gedacht war und dort solche sensiblen Informationen selbstverständlich nicht auftauchen sollen (Quellcode).

Die Nachteile

Damit eignet sich diese Funktionalität aber leider nicht mehr für einen umfassenden Blick auf das System. Wenn es jedoch nur um die wichtigsten Auffälligkeiten geht, wird in den meisten Fällen der Parameter @IgnorePrioritiesAbove mit dem Wert 50 verwendet. Diese Einstellung unterdrückt alle Sicherheitsaspekte und eine Ausgabe im Markdown-Format verändert nicht mehr den Inhalt und kann so für eine schnelle Übersicht genutzt werden:

sp_Blitz @IgnorePrioritiesAbove = 50, @OutputType = 'markdown'

Nachtrag (November 2026): Diese Aussage gilt so nicht mehr. Zum Erscheinen des Artikels hatten alle Befunde der FindingsGroup „Security" die Priority 230 und wurden von @IgnorePrioritiesAbove = 50 mit unterdrückt. Inzwischen gibt es mit den CheckIDs 258 bis 261 („Dangerous Service Account") Sicherheitsbefunde mit der Priority 1. Die Markdown-Ausgabe filtert aber nicht über die Priority, sondern über FindingsGroup <> 'Security' — sie lässt diese Befunde also auch bei @IgnorePrioritiesAbove = 50 weiterhin weg. Wer sich in dieser Kombination auf die Markdown-Ausgabe verlässt, übersieht damit den Hinweis auf ein Dienstkonto in der lokalen Administratorengruppe.

Der Ausweg

Zudem besteht natürlich die Möglichkeit, die Umwandlung von der klassischen Tabellenausgabe in das Markdown-Format selbst vorzunehmen, zum Beispiel mit PowerShell. Wie das First Responder Kit mit dem PowerShell-Modul dbatools installiert und ausgeführt wird, beschreibe ich in meinem Artikel Mit dem PowerShell-Modul dbatools das SQL Server First Responder Kit nutzen. Ich habe das programmiert und dabei auch gleich noch ein paar Konfigurationsmöglichkeiten eingebaut. Das Skript finden Sie in meinem GitHub Repository.

Bei Interesse können wir das Skript auch auf Ihre Bedürfnisse anpassen, sprechen Sie uns dazu gerne an.

{loadmoduleid 179}

Principal Consultant bei ORDIX

Ähnliche Beiträge

 

Kommentare

Derzeit gibt es keine Kommentare. Schreibe den ersten Kommentar!
Freitag, 20. November 2026

Sicherheitscode (Captcha)