{ "info": { "author": "Alan Castonguay", "author_email": "acastonguay@vmware.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Information Technology", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 3 :: Only", "Topic :: System :: Logging" ], "description": "A command-line exporter of log events in VMware vRealize Log Insight. Exceed the 20k UI limit. Write local files.\n\n# loginsight-export\n\n## Installation\n1. Open a command prompt.\n2. `pip install loginsight-export`\n3. `loginsight-export -h`\n\n## Usage\n1. In Log Insight Interactive Analytics, perform a query of arbitrary complexity and size.\n2. Use the ![](exportshare.png) Share button to generate a short url for the current query.\n3. `loginsight-export https://loginsight.example.com/s/123456`\n\n## Overview\n\n[VMware vRealize Log Insight](https://vmware.com/go/loginsight/docs) supports exporting query results to a file in the UI. However, a single export is limited to 20k results. To export more results, an operator can execute a sequence of queries with non-overlapping time-ranges, each of which contained less than 20k. As scale increases, this becomes cumbersome. This utility starts with a single UI-driven time-range, recursively breaks the full range down into sequential <=20k-sized chunks, and executes an export for each chunk.\n\n## Prerequisites\n\n* Built on [Requests](http://python-requests.org/).\n* Python 3.4 or higher.\n* Uses `tox`, `pytest`, `requests-mock` for testing.\n\n## Secure Connections\n\nThe exporter verifies a remote server's certificate against your CA trust chain by default. If Log Insight is using a valid certificate that's not trusted by your local machine (e.g., self-signed), use the `--save` command-line argument to write a local PEM file and `--verify` to trust it. The certificate's integrity is still verified.\n\nIf Log Insight is using the auto-generated certificate with a common name that doens't match Log Insight's hostname, the request will fail:\n```\nloginsightexport: error: The remote SSL certificate isn't trusted: hostname '192.168.3.30' doesn't match 'VMware vCenter Log Insight'\n```\nIt's always recommended to use real certificates. To bypass this check in a test environment, use the `--insecure` command-line argument.\n\n## Contributing\n\nThe loginsight-export project team welcomes contributions from the community. If you wish to contribute code and you have not\nsigned our contributor license agreement (CLA), our bot will update the issue when you open a Pull Request. For any\nquestions about the CLA process, please refer to our [FAQ](https://cla.vmware.com/faq). For more detailed information,\nrefer to [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\n[Distributed under the Apache Version 2.0 license](LICENSE.txt)", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/vmware/loginsight-export/", "keywords": "", "license": "Apache Software License 2.0", "maintainer": "", "maintainer_email": "", "name": "loginsight-export", "package_url": "https://pypi.org/project/loginsight-export/", "platform": "any", "project_url": "https://pypi.org/project/loginsight-export/", "project_urls": { "Homepage": "http://github.com/vmware/loginsight-export/" }, "release_url": "https://pypi.org/project/loginsight-export/0.7.3/", "requires_dist": null, "requires_python": "", "summary": "Log Insight Export", "version": "0.7.3" }, "last_serial": 3320568, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "594d181e77cf11092ebfc1a07571b335", "sha256": "40be8b3da142603cfd1a2dba1269450087337f54118d650e2e514fb9125de5bf" }, "downloads": -1, "filename": "loginsight-export-0.1.tar.gz", "has_sig": false, "md5_digest": "594d181e77cf11092ebfc1a07571b335", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19949, "upload_time": "2017-04-25T19:35:51", "url": "https://files.pythonhosted.org/packages/21/b5/19aef47077a82cad3d8c42b4bbf53040d54495aff649cfa1a336e40b94f2/loginsight-export-0.1.tar.gz" } ], "0.7.1": [ { "comment_text": "", "digests": { "md5": "38de0e2602c70a3e1f7b2a403b4cf85b", "sha256": "ea4c160d68225d4bc3ff18784d33cf66a2b9e20ad98743f74a881009916730fd" }, "downloads": -1, "filename": "loginsight-export-0.7.1.tar.gz", "has_sig": false, "md5_digest": "38de0e2602c70a3e1f7b2a403b4cf85b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20572, "upload_time": "2017-05-23T20:42:21", "url": "https://files.pythonhosted.org/packages/b0/7a/dd1c94fb92d44455dae8f73c575c31f8b77743779b9fe66c629c9cce1db9/loginsight-export-0.7.1.tar.gz" } ], "0.7.3": [ { "comment_text": "", "digests": { "md5": "cec1fac80334b36a6e9ed885eb9a85fe", "sha256": "46be2313e6409238913888ef0c73db391b2ccf16e56ac48bef5905f3b9d55938" }, "downloads": -1, "filename": "loginsight-export-0.7.3.tar.gz", "has_sig": false, "md5_digest": "cec1fac80334b36a6e9ed885eb9a85fe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20690, "upload_time": "2017-11-09T20:29:32", "url": "https://files.pythonhosted.org/packages/41/7d/cfafdbd64432b58235855984b864d05c0e65db44cb36762553bfafe21a33/loginsight-export-0.7.3.tar.gz" } ], "0.dev0": [ { "comment_text": "", "digests": { "md5": "74a75aa5cbf01a9cee0fc962f7a1e50d", "sha256": "bef6b5b6b37a59919ad21cdbc5be38bf4cce15cc420772f1baab9fcd607bed33" }, "downloads": -1, "filename": "loginsight_export-0.dev0-py3-none-any.whl", "has_sig": false, "md5_digest": "74a75aa5cbf01a9cee0fc962f7a1e50d", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 27021, "upload_time": "2017-03-06T18:20:51", "url": "https://files.pythonhosted.org/packages/23/31/4ecbea23ba39f2568271f9fbe56552fca67400c54039b4513f4f97ff8447/loginsight_export-0.dev0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e39d42cc1a1b6754ea419e92aee8438f", "sha256": "fa98429a349d01823c0e5fabffc5f3bf35a990f526c6ec50c7e5ebac5a437102" }, "downloads": -1, "filename": "loginsight-export-0.dev0.tar.gz", "has_sig": false, "md5_digest": "e39d42cc1a1b6754ea419e92aee8438f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20014, "upload_time": "2017-03-06T18:20:49", "url": "https://files.pythonhosted.org/packages/28/0c/b2393137d8aa3807398c8ebef4706c9c16229643e7b00d797c5f9a155e3d/loginsight-export-0.dev0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "cec1fac80334b36a6e9ed885eb9a85fe", "sha256": "46be2313e6409238913888ef0c73db391b2ccf16e56ac48bef5905f3b9d55938" }, "downloads": -1, "filename": "loginsight-export-0.7.3.tar.gz", "has_sig": false, "md5_digest": "cec1fac80334b36a6e9ed885eb9a85fe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20690, "upload_time": "2017-11-09T20:29:32", "url": "https://files.pythonhosted.org/packages/41/7d/cfafdbd64432b58235855984b864d05c0e65db44cb36762553bfafe21a33/loginsight-export-0.7.3.tar.gz" } ] }