{"id":20593745,"url":"https://github.com/robertcsapo/cisco-dnac-platform-syslog-notifications","last_synced_at":"2026-05-07T13:09:50.183Z","repository":{"id":139954363,"uuid":"268780447","full_name":"robertcsapo/cisco-dnac-platform-syslog-notifications","owner":"robertcsapo","description":"Send Syslog Message from Cisco DNA Center Assurance Events","archived":false,"fork":false,"pushed_at":"2020-06-02T11:29:38.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-01T12:47:05.040Z","etag":null,"topics":["assurance","cisco","cisco-dna-center","docker","docker-compose","events","rest-api","syslog"],"latest_commit_sha":null,"homepage":"https://developer.cisco.com/dnacenter/eventsandnotifications/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robertcsapo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-02T11:18:07.000Z","updated_at":"2020-06-02T11:31:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"abae01c7-a109-4c89-bd18-2d9ce7f40abd","html_url":"https://github.com/robertcsapo/cisco-dnac-platform-syslog-notifications","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/robertcsapo/cisco-dnac-platform-syslog-notifications","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertcsapo%2Fcisco-dnac-platform-syslog-notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertcsapo%2Fcisco-dnac-platform-syslog-notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertcsapo%2Fcisco-dnac-platform-syslog-notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertcsapo%2Fcisco-dnac-platform-syslog-notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robertcsapo","download_url":"https://codeload.github.com/robertcsapo/cisco-dnac-platform-syslog-notifications/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertcsapo%2Fcisco-dnac-platform-syslog-notifications/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32738979,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assurance","cisco","cisco-dna-center","docker","docker-compose","events","rest-api","syslog"],"created_at":"2024-11-16T07:49:36.841Z","updated_at":"2026-05-07T13:09:50.151Z","avatar_url":"https://github.com/robertcsapo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cisco-dnac-platform-syslog-notifications\n\n## Receive Events from Cisco DNA Center and push the information to Syslog Server\n\n## Disclaimer\n* This solution isn't using Username/Password header with Cisco DNA Center\n* You need to use HTTPS with Cisco DNA Center for Events API\n\t- It's recommended to use this service with non-https and have a loadbalancer infront (https)\n\t- SSL is now supported (ad-hoc) on this service (without LB) - not recommended for production\n\n## How to setup\n\n### Python Webhook\n\n#### Prerequisites\n* Docker support\n* Syslog Server\n\n### Start Python Webhook\n\n```\ndocker run -d -p 5000:5000 \\\n-e SYSLOG_HOST=\"10.1.1.1\" \\\nrobertcsapo/cisco-dnac-platform-syslog-notifications\n```\n\nIf SSL is need\n\n```\ndocker run -d -p 5000:5000 \\\n-e SYSLOG_HOST=\"10.1.1.1\" \\\n-e WEBHOOK_SSL=\"True\" \\\nrobertcsapo/cisco-dnac-platform-syslog-notifications\n```\n\n## Demo\n```\ntail -f var/log/messages\nJun  1 11:02:46 172.17.0.3 [2020-05-21 18:38:02] [Cisco DNA Center] 1 ALERT active [NETWORK-NON-FABRIC_WIRED-1-250] 127.0.0.1 This network device dummy.example.tld is unreachable from controller. The device role is BORDER ROUTER https://dnac.example.tld/dna/assurance/issueDetails?issueId=d81737f9-ff45-4750-a83f-31db0533fe88\n```\n\n### Cisco DNA Center\n#### Prerequisites\n* Enable Cisco DNA Center as a Platform\n\t- How-To Guide https://www.cisco.com/c/en/us/td/docs/cloud-systems-management/network-automation-and-management/dna-center-platform/1-3-1-0/user_guide/b_dnac_platform_ug_1_3_1_0/b_dnac_platform_ug_1_3_1_0_chapter_010.html\n* Configure Cisco DNA Center Events (https://\u003cdnac-ip\u003e/dna/systemSettings/settings?settings-item=dnacp-events-settings)\n\t- How-To Guide https://www.cisco.com/c/en/us/td/docs/cloud-systems-management/network-automation-and-management/dna-center-platform/1-3-1-0/user_guide/b_dnac_platform_ug_1_3_1_0/b_dnac_platform_ug_1_3_1_0_chapter_010.html\n\n## URI\n\n### Cisco DNA Center\nPoint your Cisco DNA Center Events Destination towards ```https://\u003cyourhost\u003e:\u003cport\u003e/dnac```\n\n### Test Function\n\n#### GET\n```\ncurl https://\u003cyourhost\u003e:\u003cport\u003e/test\n```\n\nThis will make the service send a test message to your syslog in same format as Cisco DNA Center.\n\n#### POST\n```\ncurl --location --request POST 'https://\u003cyourhost\u003e:\u003cport\u003e/test' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n            \"version\": null,\n            \"instanceId\": \"d81737f9-ff45-4750-a83f-31db0533fe88\",\n            \"eventId\": \"NETWORK-NON-FABRIC_WIRED-1-250\",\n            \"namespace\": \"ASSURANCE\",\n            \"name\": null,\n            \"description\": null,\n            \"type\": \"NETWORK\",\n            \"category\": \"ERROR\",\n            \"domain\": \"Connectivity\",\n            \"subDomain\": \"Non-Fabric Wired\",\n            \"severity\": 1,\n            \"source\": \"ndp\",\n            \"timestamp\": 1590086282484,\n            \"tags\": null,\n            \"details\": {\n                \"Type\": \"Network Device\",\n                \"Assurance Issue Priority\": \"P1\",\n                \"Assurance Issue Details\": \"This network device example.tld is unreachable from controller. The device role is BORDER ROUTER\",\n                \"Device\": \"10.1.2.3\",\n                \"Assurance Issue Name\": \"Network Device 10.1.2.3 Is Unreachable From Controller\",\n                \"Assurance Issue Category\": \"Availability\",\n                \"Assurance Issue Status\": \"active\"\n                },\n                \"ciscoDnaEventLink\": \"https://\u003cyour-cisco-dna-center\u003e/dna/assurance/issueDetails?issueId=d81737f9-ff45-4750-a83f-31db0533fe88\",\n                \"note\": \"To programmatically get more info see here - https://\u003cip-address\u003e/dna/platform/app/consumer-portal/developer-toolkit/apis?apiId=8684-39bb-4e89-a6e4\",\n                \"tntId\": \"\",\n                \"context\": null,\n                \"tenantId\": \"\"\n            }'\n```\n\n## Help\n```\ndocker run --rm -it robertcsapo/cisco-dnac-platform-syslog-notifications --help\n\nusage: run.py [-h] [--host HOST] [--port PORT] [--protocol PROTOCOL] [--ssl] [--version]\n\ncisco-dnac-platform-syslog-notifications\n\noptional arguments:\n  -h, --help           show this help message and exit\n  --host HOST          Syslog Server Host\n  --port PORT          Syslog Server Port (default: 514)\n  --protocol PROTOCOL  The protocol to send syslog messages as (default: udp)\n  --ssl                Webhook with dummy SSL (default: False)\n  --version            show program's version number and exit\n```\n\n## Technologies \u0026 Frameworks Used\n\n**Cisco Products \u0026 Services:**\n\n- Cisco DNA Center\n\n**Third-Party Products \u0026 Services:**\n\n- Syslog Server\n\n**Tools \u0026 Frameworks:**\n\n- Python\n- Flask\n- Docker\n\n## Authors \u0026 Maintainers\n\n- Robert Csapo \u003crcsapo@cisco.com\u003e\n\n## Credits\n\nInspired by Oren Brigg at Cisco repo about syslog and Cisco DNA Center\nhttps://github.com/obrigg/cisco-dnac-platform-syslog-audit\n\n## License\n\nThis project is licensed to you under the terms of the [Cisco Sample\nCode License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertcsapo%2Fcisco-dnac-platform-syslog-notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobertcsapo%2Fcisco-dnac-platform-syslog-notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertcsapo%2Fcisco-dnac-platform-syslog-notifications/lists"}