# mylesagnew/azure-syslog architecture

> Architecture diagram of the GitHub repository mylesagnew/azure-syslog, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mylesagnew/azure-syslog
- Repository: https://github.com/mylesagnew/azure-syslog

## Overview

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: [`terraform/main.tf`](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/main.tf) (Terraform deployment), [`terraform/compute.tf`](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/compute.tf) (Collector VMs), [`ansible/roles/rsyslog_collector/files/syslog-archive.py`](https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/files/syslog-archive.py) (Archive worker), [`ansible/roles/rsyslog_collector/templates/rsyslog.conf.j2`](https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/templates/rsyslog.conf.j2) (rsyslog receiver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provision["Infrastructure"]
  node_terraform["Terraform deployment<br/>[main.tf]"]
  node_network["Private network and LB<br/>[network.tf]"]
  node_compute["Collector VMs<br/>[compute.tf]"]
  node_dns["Private DNS<br/>[dns.tf]"]
  node_storageinfra["Archive storage setup<br/>[storage.tf]"]
  node_keyvault["Certificate access<br/>[keyvault.tf]"]
  node_monitoring["Monitoring setup<br/>[monitoring.tf]"]
end

subgraph group_configure["Host configuration"]
  node_baseline["OS hardening<br/>[main.yml]"]
  node_collectorconfig["Collector configuration<br/>[main.yml]"]
  node_archiveworker["Archive worker<br/>[syslog-archive.py]"]
end

subgraph group_ingest["Log collection"]
  node_syslog["rsyslog receiver<br/>[rsyslog.conf.j2]"]
  node_logrotate["Log rotation"]
  node_localfiles[("Local log files")]
end

subgraph group_integrations["Cloud integrations"]
  node_azure["Azure resources"]
  node_blob[("Cool-tier Blob")]
  node_ama["Azure Monitor Agent"]
  node_sentinel[("Log Analytics / Sentinel")]
  node_vault[("Key Vault")]
end

node_operator(("Cloud Shell operator"))
node_senders(("Syslog senders"))

node_operator -->|"runs"| node_terraform
node_terraform -->|"provisions"| node_network
node_terraform -->|"provisions"| node_compute
node_terraform -->|"configures"| node_dns
node_terraform -->|"provisions"| node_storageinfra
node_terraform -->|"configures"| node_keyvault
node_terraform -->|"configures"| node_monitoring
node_compute -->|"runs Ansible"| node_baseline
node_compute -->|"runs Ansible"| node_collectorconfig
node_senders -->|"send logs"| node_syslog
node_syslog -->|"writes"| node_localfiles
node_logrotate -->|"rotates"| node_localfiles
node_archiveworker -->|"reads and prunes"| node_localfiles
node_archiveworker -->|"uploads and verifies"| node_blob
node_archiveworker -->|"gets identity token"| node_vault
node_syslog -->|"forwards logs"| node_ama
node_ama -->|"sends telemetry"| node_sentinel
node_monitoring -->|"associates DCR"| node_sentinel
node_compute -->|"retrieves TLS cert"| node_vault
node_network -->|"allows private traffic"| node_senders

click node_terraform "https://github.com/mylesagnew/azure-syslog/blob/main/terraform/main.tf"
click node_network "https://github.com/mylesagnew/azure-syslog/blob/main/terraform/network.tf"
click node_compute "https://github.com/mylesagnew/azure-syslog/blob/main/terraform/compute.tf"
click node_dns "https://github.com/mylesagnew/azure-syslog/blob/main/terraform/dns.tf"
click node_storageinfra "https://github.com/mylesagnew/azure-syslog/blob/main/terraform/storage.tf"
click node_keyvault "https://github.com/mylesagnew/azure-syslog/blob/main/terraform/keyvault.tf"
click node_monitoring "https://github.com/mylesagnew/azure-syslog/blob/main/terraform/monitoring.tf"
click node_baseline "https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/baseline_hardening/tasks/main.yml"
click node_collectorconfig "https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/tasks/main.yml"
click node_archiveworker "https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/files/syslog-archive.py"
click node_syslog "https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/templates/rsyslog.conf.j2"
click node_logrotate "https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/templates/logrotate-remote.j2"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_terraform,node_network,node_compute,node_dns,node_storageinfra,node_keyvault,node_monitoring toneBlue
class node_baseline,node_collectorconfig,node_archiveworker toneAmber
class node_syslog,node_logrotate,node_localfiles toneMint
class node_azure,node_blob,node_ama,node_sentinel,node_vault toneRose
class node_operator,node_senders toneIndigo
```

## Components

### Infrastructure

- [Terraform deployment](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/main.tf): `terraform/main.tf`
- [Private network and LB](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/network.tf): `terraform/network.tf`
- [Collector VMs](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/compute.tf): `terraform/compute.tf`
- [Private DNS](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/dns.tf): `terraform/dns.tf`
- [Archive storage setup](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/storage.tf): `terraform/storage.tf`
- [Certificate access](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/keyvault.tf): `terraform/keyvault.tf`
- [Monitoring setup](https://github.com/mylesagnew/azure-syslog/blob/main/terraform/monitoring.tf): `terraform/monitoring.tf`

### Host configuration

- [OS hardening](https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/baseline_hardening/tasks/main.yml): `ansible/roles/baseline_hardening/tasks/main.yml`
- [Collector configuration](https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/tasks/main.yml): `ansible/roles/rsyslog_collector/tasks/main.yml`
- [Archive worker](https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/files/syslog-archive.py): `ansible/roles/rsyslog_collector/files/syslog-archive.py`

### Log collection

- [rsyslog receiver](https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/templates/rsyslog.conf.j2): `ansible/roles/rsyslog_collector/templates/rsyslog.conf.j2`
- [Log rotation](https://github.com/mylesagnew/azure-syslog/blob/main/ansible/roles/rsyslog_collector/templates/logrotate-remote.j2): `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

- Cloud Shell operator → Terraform deployment: runs (evidence: `README.md`)
- Terraform deployment → Private network and LB: provisions (evidence: `README.md`)
- Terraform deployment → Collector VMs: provisions (evidence: `README.md`)
- Terraform deployment → Private DNS: configures (evidence: `README.md`)
- Terraform deployment → Archive storage setup: provisions (evidence: `README.md`)
- Terraform deployment → Certificate access: configures (evidence: `README.md`)
- Terraform deployment → Monitoring setup: configures (evidence: `README.md`)
- Collector VMs → OS hardening: runs Ansible (evidence: `README.md`)
- Collector VMs → Collector configuration: runs Ansible (evidence: `README.md`)
- Syslog senders → rsyslog receiver: send logs (evidence: `README.md`)
- rsyslog receiver → Local log files: writes (evidence: `README.md`)
- Log rotation → Local log files: rotates (evidence: `README.md`)
- Archive worker → Local log files: reads and prunes (evidence: `ansible/roles/rsyslog_collector/files/syslog-archive.py`)
- Archive worker → Cool-tier Blob: uploads and verifies (evidence: `ansible/roles/rsyslog_collector/files/syslog-archive.py`)
- Archive worker → Key Vault: gets identity token (evidence: `ansible/roles/rsyslog_collector/files/syslog-archive.py`)
- rsyslog receiver → Azure Monitor Agent: forwards logs (evidence: `README.md`)
- Azure Monitor Agent → Log Analytics / Sentinel: sends telemetry (evidence: `README.md`)
- Monitoring setup → Log Analytics / Sentinel: associates DCR (evidence: `README.md`)
- Collector VMs → Key Vault: retrieves TLS cert (evidence: `README.md`)
- Private network and LB → Syslog senders: allows private traffic (evidence: `README.md`)
