azure-linux-extensions/Diagnostic
..
Providers
Utils
mdsd
media/virtual-machines-linux-diagnostic-extension-v3
mocks
services
tests
ChangeLogs
DistroSpecific.py
HandlerManifest.json
Makefile
README.md
__init__.py
decrypt_protected_settings.sh
diagnostic.py
lad_config_all.py
lad_mdsd.te
license.txt
manifest.xml
run_unittests.sh
shim.sh
virtual-machines-linux-diagnostic-extension-v3.md
watcherutil.py

README.md

Linux Diagnostic Extension (LAD)

Allow the owner of a Linux-based Azure Virtual Machine to obtain diagnostic data.

Current version is 3.0.129.

Linux Azure Diagnostic (LAD) extension version 3.0 is released with the following changes:

  • Fully configurable Azure Portal metrics, including a broader set of metrics to choose from.
  • Syslog message collection is now opt-in (off by default), and customers can selectively pick and choose syslog facilities and minimum severities of their interests.
  • Customers can now use CLI to configure their Azure Linux VMs for Azure Portal VM metrics charting experiences.
  • Customers can now send any metrics and logs as Azure EventHubs events (additional Azure EventHubs charges may apply).
  • Customers can also store any metrics and logs in Azure Storage JSON blobs (additional Azure Storage charges may apply).

LAD 3.0 is NOT compatible with LAD 2.3. Users of LAD 2.3 must first uninstall that extension before installing LAD 3.0.

LAD 3.0 is installed and configured via Azure CLI, Azure PowerShell cmdlets, or Azure Resource Manager templates. The Azure Portal controls installation and configuration of LAD 2.3 only. The Azure Metrics UI can display performance counters collected by either version of LAD.

Please refer to this document for more details on configuring and using LAD 3.0. The tests folder contains a sample JSON configuration which sets LAD 3.0 to collecting exactly the same metrics and logs as the default configuration for LAD 2.3 collected.

Supported Linux Distributions

List of supported Linux distributions is on https://docs.microsoft.com/en-us/azure/virtual-machines/extensions/diagnostics-linux#supported-linux-distributions

Debug

  • The status of the extension is reported back to Azure so that user can see the status on Azure Portal
  • The operation log of the extension is /var/log/azure/Microsoft.Azure.Diagnostics.LinuxDiagnostic/<version>/ directory.