{"id":22960012,"url":"https://github.com/zhmcclient/zhmc-log-forwarder","last_synced_at":"2025-08-13T05:32:48.244Z","repository":{"id":228335462,"uuid":"773720575","full_name":"zhmcclient/zhmc-log-forwarder","owner":"zhmcclient","description":"A forwarder for HMC audit and security logs","archived":false,"fork":false,"pushed_at":"2024-12-12T13:57:20.000Z","size":1939,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-12T14:32:21.855Z","etag":null,"topics":["hmc","logging","mainframe","python","s390x"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhmcclient.png","metadata":{"files":{"readme":"README.md","changelog":"changes/.gitignore","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-18T09:26:51.000Z","updated_at":"2024-12-12T13:40:09.000Z","dependencies_parsed_at":"2024-03-18T10:03:09.743Z","dependency_job_id":"860707ef-57b9-421a-aab1-8aac7bd1c513","html_url":"https://github.com/zhmcclient/zhmc-log-forwarder","commit_stats":null,"previous_names":["zhmcclient/zhmc-log-forwarder"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fzhmc-log-forwarder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fzhmc-log-forwarder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fzhmc-log-forwarder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fzhmc-log-forwarder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhmcclient","download_url":"https://codeload.github.com/zhmcclient/zhmc-log-forwarder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229740284,"owners_count":18116931,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["hmc","logging","mainframe","python","s390x"],"created_at":"2024-12-14T18:30:02.422Z","updated_at":"2025-08-13T05:32:48.224Z","avatar_url":"https://github.com/zhmcclient.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A log forwarder for the IBM Z HMC\n\n[![Version on Pypi](https://img.shields.io/pypi/v/zhmc-log-forwarder.svg)](https://pypi.python.org/pypi/zhmc-log-forwarder/)\n[![Docs status (master)](https://readthedocs.org/projects/zhmc-log-forwarder/badge/?version=latest)](https://readthedocs.org/projects/zhmc-log-forwarder/builds/)\n[![Test status (master)](https://github.com/zhmcclient/zhmc-log-forwarder/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/zhmcclient/zhmc-log-forwarder/actions/workflows/test.yml?query=branch%3Amaster)\n[![Test coverage (master)](https://coveralls.io/repos/github/zhmcclient/zhmc-log-forwarder/badge.svg?branch=master)](https://coveralls.io/github/zhmcclient/zhmc-log-forwarder?branch=master)\n\n# Overview\n\nThe zhmc-log-forwarder package provides a log forwarder for the\n[IBM Z](https://www.ibm.com/it-infrastructure/z) Hardware Management Console\n(HMC), written in pure Python.\n\nIt contains a command named `zhmc_log_forwarder` that collects security\nlogs and audit logs from the Z HMC and forwards the log entries to\nvarious destinations, such as stdout, the local syslog, or a QRadar\nservice.\n\nThe command can gather log entries from the past, since a specified date\nand time, or since specific points such as now or all available entries.\nThe command can in addition subscribe for notifications from the HMC\nabout new log entries, so that it can wait for any future log entries to\nappear.\n\nThe log forwarder supports the following destinations:\n\n- Standard output\n- Standard error\n- rsyslog server\n\nand the following formats:\n\n- Single line format\n- [Cloud Auditing Data Federation](https://www.dmtf.org/standards/cadf) (CADF)\n  format, represented as a JSON string\n\n\n# Installation\n\n- If not yet available, install the \"pipx\" command as described in\n  https://pipx.pypa.io/stable/installation/.\n\n- Without having any virtual Python environment active, install the log\n  forwarder as follows:\n\n  ``` bash\n  $ pipx install zhmc-log-forwarder\n  ```\n\n  That makes the `zhmc_log_forwarder` command available in the PATH, without\n  having to activate any virtual Python environment.\n\n# Quickstart\n\n1.  Make sure you installed the zhmc-log-forwarder package (see the\n    previous section).\n\n2.  Create a config file for the `zhmc_log_forwarder` command. The\n    config file specifies the targeted HMC, the desired destination for\n    the logs, and other data.\n\n    An example config file with explanations of the parameters is shown\n    when invoking:\n\n    ``` bash\n    $ zhmc_log_forwarder --help-config-file\n    ```\n\n    Additionally, an example config file is here:\n    [example_config_file.yml](https://github.com/zhmcclient/zhmc-log-forwarder/blob/master/example_config_file.yml)\n\n    Redirect that output into a file and edit that file as needed.\n\n3.  Optional: The zhmc-log-forwarder package includes a default HMC log\n    message file. That file is used when generating CADF output format\n    and defines how the HMC log messages are classified in the CADF\n    output. It is possible to specify your own HMC log message file\n    using the `log_message_file` parameter in the config file. When\n    omitting this parameter, or when setting it to `null`, the default\n    HMC log message file included with the zhmc-log-forwarder package is\n    used.\n\n    An example HMC log message file explaining its format is shown when\n    invoking:\n\n    ``` text\n    $ zhmc_log_forwarder --help-log-message-file\n    ```\n\n4.  Start the `zhmc_log_forwarder` command as follows:\n\n    ``` text\n    $ zhmc_log_forwarder -c CONFIGFILE\n    ```\n\n    Where `CONFIGFILE` is the file path of the created config file.\n\n    The command will run forever (or until stopped with Ctrl-C) and will\n    forward the log records as specified in the config file.\n\n# Documentation and Change Log\n\n- [Documentation](http://zhmc-log-forwarder.readthedocs.io)\n- [Change log](http://zhmc-log-forwarder.readthedocs.io/en/master/changes.html)\n\n# License\n\nThe zhmc-log-forwarder package is licensed under the [Apache 2.0\nLicense](https://github.com/zhmcclient/zhmc-log-forwarder/tree/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhmcclient%2Fzhmc-log-forwarder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhmcclient%2Fzhmc-log-forwarder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhmcclient%2Fzhmc-log-forwarder/lists"}