How mylesagnew/azure-syslog works
azure-syslog deploys and configures a private, zone-redundant Azure syslog service. The principal flow is infrastructure provisioning, collector hardening and rsyslog setup, log reception and local retention, then archival to Blob and forwarding to Log Analytics/Sentinel. The README documents the main Terraform and Ansible responsibilities; the only sampled source is the archive worker, so its upload, integrity-check and pruning behavior is shown directly, while other relationships rely on README statements.
Main entry points: main.tf Terraform deployment · compute.tf Collector VMs · syslog-archive.py Archive worker · rsyslog.conf.j2 rsyslog receiver
Components 20
Infrastructure
- Terraform deployment
terraform/main.tf - Private network and LB
terraform/network.tf - Collector VMs
terraform/compute.tf - Private DNS
terraform/dns.tf - Archive storage setup
terraform/storage.tf - Certificate access
terraform/keyvault.tf - Monitoring setup
terraform/monitoring.tf
Host configuration
- OS hardening
ansible/roles/baseline_hardening/tasks/main.yml - Collector configuration
ansible/roles/rsyslog_collector/tasks/main.yml - Archive worker
ansible/roles/rsyslog_collector/files/syslog-archive.py
Log collection
- rsyslog receiver
ansible/roles/rsyslog_collector/templates/rsyslog.conf.j2 - Log rotation
ansible/roles/rsyslog_collector/templates/logrotate-remote.j2 - Local log files
Cloud integrations
- Azure resources
- Cool-tier Blob
- Azure Monitor Agent
- Log Analytics / Sentinel
- Key Vault
Other components
- Cloud Shell operator
- Syslog senders
Connections 20
- Cloud Shell operator → Terraform deployment: runs
README.md - Terraform deployment → Private network and LB: provisions
README.md - Terraform deployment → Collector VMs: provisions
README.md - Terraform deployment → Private DNS: configures
README.md - Terraform deployment → Archive storage setup: provisions
README.md - Terraform deployment → Certificate access: configures
README.md - Terraform deployment → Monitoring setup: configures
README.md - Collector VMs → OS hardening: runs Ansible
README.md - Collector VMs → Collector configuration: runs Ansible
README.md - Syslog senders → rsyslog receiver: send logs
README.md - rsyslog receiver → Local log files: writes
README.md - Log rotation → Local log files: rotates
README.md - Archive worker → Local log files: reads and prunes
ansible/roles/rsyslog_collector/files/syslog-archive.py - Archive worker → Cool-tier Blob: uploads and verifies
ansible/roles/rsyslog_collector/files/syslog-archive.py - Archive worker → Key Vault: gets identity token
ansible/roles/rsyslog_collector/files/syslog-archive.py - rsyslog receiver → Azure Monitor Agent: forwards logs
README.md - Azure Monitor Agent → Log Analytics / Sentinel: sends telemetry
README.md - Monitoring setup → Log Analytics / Sentinel: associates DCR
README.md - Collector VMs → Key Vault: retrieves TLS cert
README.md - Private network and LB → Syslog senders: allows private traffic
README.md