{"id":35544401,"url":"https://github.com/zebrium/ze-cli","last_synced_at":"2026-01-04T06:01:05.554Z","repository":{"id":79215782,"uuid":"204762824","full_name":"zebrium/ze-cli","owner":"zebrium","description":"Zebrium's command line interface for uploading log events for automated anomaly detection.","archived":false,"fork":false,"pushed_at":"2024-07-30T14:27:56.000Z","size":433,"stargazers_count":6,"open_issues_count":3,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-07-31T17:29:27.764Z","etag":null,"topics":["anomaly-detection","log-analytics","log-collector","log-management","structured-data"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zebrium.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-27T18:13:59.000Z","updated_at":"2024-07-30T14:26:15.000Z","dependencies_parsed_at":"2023-03-27T09:56:42.853Z","dependency_job_id":"e264b475-c403-46fb-853b-ac4012ae148a","html_url":"https://github.com/zebrium/ze-cli","commit_stats":{"total_commits":68,"total_committers":8,"mean_commits":8.5,"dds":"0.32352941176470584","last_synced_commit":"7362767942eb0a373f2219ec7e12f521d967ac24"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/zebrium/ze-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebrium%2Fze-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebrium%2Fze-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebrium%2Fze-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebrium%2Fze-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zebrium","download_url":"https://codeload.github.com/zebrium/ze-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebrium%2Fze-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28198653,"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","status":"online","status_checked_at":"2026-01-04T02:00:06.065Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["anomaly-detection","log-analytics","log-collector","log-management","structured-data"],"created_at":"2026-01-04T06:00:20.940Z","updated_at":"2026-01-04T06:01:05.549Z","avatar_url":"https://github.com/zebrium.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZE CLI Tool\n\n`ze` is Zebrium's command line interface for uploading log events from files or streams.  Please visit the official [ScienceLogic's docs page](https://docs.sciencelogic.com/zebrium/latest/Content/Web_Zebrium/03_Log_Collectors_Uploads/File_Uploads_ze.html) for the full documentation.\n\n## Getting Started\n\n### Installing\n\n* Download the corresponding release from the releases [page](https://github.com/zebrium/ze-cli/releases)\n* Unzip the downloaded file in\n* Set up your path in your shell config to include the new binary\n* Start a new terminal and test your installation\n `ze -v`\n\n## Configuration\n\nThe ze cli tool supports a variety of ways to set its parameters.  All parameters are\nsettable via args.  To find out the args available and required for each call, use `ze -help`\nor `ze \u003csubcommand\u003e -help`  When leveraging the configuration file or ENV variables, ze cli will use the following\nprecedence: Config File -\u003e Env Files -\u003e Command Line Args\n\n### Configuration File\n\n The ze cli tool does support setting global variables in a .ze file for easy\n configuration. The default location of this is `$HOME/.ze`, however this can overridden\n with passing a new path with the `--config` option. The contents of that file is as follows:\n\n``` bash\nauth: XXXXXXXXXX\nurl: https://cloud.zebrium.com\n```\n\n### Environment Variables\n\nThe ze cli supports setting the following env variables\n\n``` bash\nZE_AUTH: XXXXXXXXXXXX\nZE_URL: https://cloud.zebrium.com\n```\n\n## Upload Commands\n\nThe ze up command is used to upload log event data to your Zebrium instance from a file or stream (STDIN) with appropriate metadata.  To see a full list of upload options, please run the command:\n\n```bash\nze up --help\n```\n\nExample Usages:\n\nIngest three log files associated with the same support case \"sr12345\" (does not assume a .ze configuration file exists):\n\n```ze up --file=/casefiles/sr12345/messages.log --svcgrp=sr12345 --host=node01 --log=messages --url=\u003cZE_LOG_COLLECTOR_URL\u003e --auth=\u003cZE_LOG_COLLECTOR_TOKEN\u003e```\n\n```ze up --file=/casefiles/sr12345/application.log --svcgrp=sr12345 --host=node01 --log=application --url=\u003cZE_LOG_COLLECTOR_URL\u003e --auth=\u003cZE_LOG_COLLECTOR_TOKEN\u003e```\n\n```ze up --file=/casefiles/sr12345/db.log --svcgrp=sr12345 --host=db01 --log=db --url=\u003cZE_LOG_COLLECTOR_URL\u003e --auth=\u003cZE_LOG_COLLECTOR_TOKEN\u003e```\n\nIngest a continuous tail of /var/log/messages. When reading from a stream, such as STDIN, rather than from a file, ze requires the –log flag (assumes a .ze configuration file exists):\n\n```tail -f /var/log/messages | ze up --log=varlogmsgs --svcgrp=monitor01 --host=mydbhost```\n\n## Batch Commands\n\nPlease see [zebrium batch documentation](ze_batch_uploads.md)\n\n## Migrating from the perl based ze-cli\n\nThe existing perl based application can be found [here](/legacy/bin)\n\n### .zerc file\n\n The .zerc file is now replaced with a .ze file that accepts the configuration\n in yaml.  This is described [here](#configuration-file)  This means that configs that was specified as\n\n```text\nurl=\u003cZE_LOG_COLLECTOR_URL\u003e\nauth=\u003cZE_LOG_COLLECTOR_TOKEN\u003e\n```\n\nwill now need to be\n\n```yaml\nurl: \u003cZE_LOG_COLLECTOR_URL\u003e\nauth: \u003cZE_LOG_COLLECTOR_TOKEN\u003e\n```\n\n### ENV Variables\n\nWe now support setting env variables. currently we support the following list:\n\n```text\nZE_URL = \u003cZE_LOG_COLLECTOR_URL\u003e\nZE_AUTH = \u003cZE_LOG_COLLECTOR_TOKEN\u003e\n```\n\n## Issues\n\nIf you are having issues or need assistance with your Zebrium deployment or POC, please reach out to \u003csupport@zebrium.com\u003e  If you are reporting a bug in the software, then feel free to open an issues on this repository  For Security Issues, please see [SECURITY.md](SECURITY.md)\n\n## Contributors\n\n* Braeden Earp (ScienceLogic)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebrium%2Fze-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzebrium%2Fze-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebrium%2Fze-cli/lists"}