{ "info": { "author": "Dark Secret Software Inc.", "author_email": "admin@darksecretsoftware.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "klugman\n=======\n\nPython library and cmdline tools for accessing Quincy.\n\nUsing Klugman as a client library:\n\n```\nfrom klugman import v1\n\n# NOTE: include version number in URL!\nevents = v1.Events('http://www.example.com:8000/v1')\ndata = events.get_events_count(name='compute.instance.update')\n\nstreams = v1.Streams('http://www.example.com:8000/v1')\ndata = streams.get_streams(state='completed', details=True)\n```\n\nCommand-line Examples:\n\n```\n$ klugman http://127.0.0.1 streams -h\nusage: klugman url streams [-h] [--name trigger_name] [--from datetime]\n [--to datetime] [--traits trait_list] [--details]\n [--state {active,firing,expiring,error,expire_error,completed,retry_fire,retry_expire}]\n [--count | --id stream_id]\n\noptional arguments:\n -h, --help show this help message and exit\n --name trigger_name Return streams of type trigger_name.\n --from datetime Return streams last updated after datetime\n --to datetime Return streams last updated before datetime\n --traits trait_list Return streams with specific distinguishing traits.\n --details Return full event details.\n --state {active,firing,expiring,error,expire_error,completed,retry_fire,retry_expire}\n Only return streams in this state.\n --count Return a count of streams matching filter criteria.\n --id stream_id Return a single specific stream by id.\n\n$ klugman http://stacktach3-api01.example.com:8000 streams --count\n+----------+-------+\n| Property | Value |\n+----------+-------+\n| count | 44216 |\n+----------+-------+\n\n$ klugman http://stacktach3-api01.example.com:8000 streams --count --state completed\n+----------+-------+\n| Property | Value |\n+----------+-------+\n| count | 42571 |\n+----------+-------+\n\n\n$ klugman http://stacktach3-api01.example.com:8000 streams\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Section | Property | Value |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Stream | id | 44171 |\n| Stream | state | active |\n| Stream | name | test_trigger |\n| Stream | first_event | 2015-04-22 21:06:09.400561 |\n| Stream | last_event | 2015-04-22 21:07:17.317974 |\n| Stream | fire_timestamp | None |\n| Stream | expire_timestamp | 2015-04-24 21:07:17.317974 |\n| D.Trait | instance_id | 3ed27346-5906-4790-9b6e-e095e5b0cfa4 |\n| D.Trait | timestamp | TimeRange from datetime.datetime(2015, 4, 22, 0, 0) to datetime.datetime(2015, 4, 23, 0, 0) |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n\n$ klugman http://stacktach3-api01.example.com:8000 streams --id 44171 --detail\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Section | Property | Value |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Stream | id | 44171 |\n| Stream | state | active |\n| Stream | name | test_trigger |\n| Stream | first_event | 2015-04-22 21:06:09.400561 |\n| Stream | last_event | 2015-04-22 21:15:05.962515 |\n| Stream | fire_timestamp | None |\n| Stream | expire_timestamp | 2015-04-24 21:15:05.962515 |\n| D.Trait | instance_id | 3ed12384-5906-4790-9b6e-e095e5b0cfa4 |\n| D.Trait | timestamp | TimeRange from datetime.datetime(2015, 4, 22, 0, 0) to datetime.datetime(2015, 4, 23, 0, 0) |\n+---------+------------------+---------------------------------------------------------------------------------------------+\nEvents:\n+--------------------+------------------------------------------+\n| Property | Value |\n+--------------------+------------------------------------------+\n| disk_gb | 40 |\n| display_name | my_ubuntu1404 |\n| ephemeral_gb | 0 |\n| event_type | compute.instance.update |\n| host | nova-api05.example.com |\n| instance_flavor | 1GB Standard Instance |\n| instance_flavor_id | 3 |\n| instance_id | 3ed23782-5906-4790-9b6e-e095e5b0cfa4 |\n| instance_type | 1GB Standard Instance |\n| memory_mb | 1024 |\n| message_id | a58e25ed-01f3-42d8-8979-5f1603ab2468 |\n| os_architecture | x64 |\n| os_distro | com.ubuntu |\n| os_version | 14.04 |\n| request_id | req-758de1f9-03e9-4337-af7d-d9efe3efc730 |\n| root_gb | 40 |\n| service | api |\n| state | building |\n| state_description | scheduling |\n| tenant_id | 1234 |\n| timestamp | 2015-04-22 21:06:09.400561 |\n| user_id | 4567 |\n| vcpus | 1 |\n+--------------------+------------------------------------------+\n+--------------------+------------------------------------------+\n| Property | Value |\n+--------------------+------------------------------------------+\n| disk_gb | 40 |\n| display_name | my_ubuntu1404 |\n| ephemeral_gb | 0 |\n| event_type | compute.instance.update |\n| host | c-88-77-44-2 |\n| instance_flavor | 1GB Standard Instance |\n| instance_flavor_id | 3 |\n| instance_id | 3ed23782-5906-4790-9b6e-e095e5b0cfa4 |\n| instance_type | 1GB Standard Instance |\n| memory_mb | 1024 |\n| message_id | dbb6a5c0-08b8-45c8-85b4-a77b2b876bc3 |\n| os_architecture | x64 |\n| os_distro | com.ubuntu |\n| os_version | 14.04 |\n| request_id | req-758de1f9-03e9-4337-af7d-d9efe3efc730 |\n| root_gb | 40 |\n| service | None |\n| state | building |\n| state_description | |\n| tenant_id | 1234 |\n| timestamp | 2015-04-22 21:06:09.888688 |\n| user_id | 4567 |\n| vcpus | 1 |\n+--------------------+------------------------------------------+\n\n\n$ klugman http://stacktach3-api01.example.com:8000 streams --traits instance_id:633fe23b-7c6a-dead-beef-55fcc6803cbc\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Section | Property | Value |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Stream | id | 43993 |\n| Stream | state | active |\n| Stream | name | test_trigger |\n| Stream | first_event | 2015-04-22 18:21:28.462931 |\n| Stream | last_event | 2015-04-22 18:21:28.462931 |\n| Stream | fire_timestamp | None |\n| Stream | expire_timestamp | 2015-04-24 18:21:28.462931 |\n| D.Trait | instance_id | 633fe23b-7c6a-dead-beef-55fcc6803cbc |\n| D.Trait | timestamp | TimeRange from datetime.datetime(2015, 4, 22, 0, 0) to datetime.datetime(2015, 4, 23, 0, 0) |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Section | Property | Value |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Stream | id | 43992 |\n| Stream | state | active |\n| Stream | name | test_trigger |\n| Stream | first_event | 2015-04-22 18:21:27.905027 |\n| Stream | last_event | 2015-04-22 18:24:18.985118 |\n| Stream | fire_timestamp | None |\n| Stream | expire_timestamp | 2015-04-24 18:24:18.985118 |\n| D.Trait | instance_id | 633fe23b-7c6a-dead-beef-55fcc6803cbc |\n| D.Trait | timestamp | TimeRange from datetime.datetime(2015, 4, 22, 0, 0) to datetime.datetime(2015, 4, 23, 0, 0) |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n\n$ klugman http://stacktach3-api01.example.com:8000 streams --state completed\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Section | Property | Value |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n| Stream | id | 43498 |\n| Stream | state | completed |\n| Stream | name | test_trigger |\n| Stream | first_event | 2015-04-20 00:00:18.740466 |\n| Stream | last_event | 2015-04-20 00:00:18.740466 |\n| Stream | fire_timestamp | 2015-04-22 11:53:37.441695 |\n| Stream | expire_timestamp | 2015-04-22 00:00:18.740466 |\n| D.Trait | instance_id | 7080633a-ffa3-dead-beef-d1549b4ac049 |\n| D.Trait | timestamp | TimeRange from datetime.datetime(2015, 4, 19, 0, 0) to datetime.datetime(2015, 4, 20, 0, 0) |\n+---------+------------------+---------------------------------------------------------------------------------------------+\n\n$ klugman http://127.0.0.1 events -h\nusage: klugman url events [-h] [--name event_name] [--from datetime]\n[--to datetime] [--traits trait_list]\n[--count | --msg_id message_id]\n\noptional arguments:\n-h, --help show this help message and exit\n--name event_name Return events of type event_name.\n--from datetime Return events generated before datetime\n--to datetime Return events generated after datetime\n--traits trait_list Return events with specific traits.\n--count Return a count of events matching filter criteria.\n--msg_id message_id Return a single specific event by message id.\n\n\n$ klugman http://stacktach3-api01.example.com:8000 events \n+--------------------+------------------------------------------+\n| Property | Value |\n+--------------------+------------------------------------------+\n| _mark | 6544b |\n| disk_gb | 80 |\n| display_name | My_Display_Name |\n| ephemeral_gb | 0 |\n| event_type | compute.instance.update |\n| host | c-11-22-33-4 |\n| instance_flavor | 2GB Standard Instance |\n| instance_flavor_id | 4 |\n| instance_id | 85240caf-71cf-dead-beef-6735298e6090 |\n| instance_type | 2GB Standard Instance |\n| memory_mb | 2048 |\n| message_id | c49d08be-dae5-4740-8f04-fb4cc27ac2fa |\n| os_architecture | x64 |\n| os_distro | org.centos |\n| os_version | 7 |\n| request_id | req-16b4995e-8a14-4b25-bd1c-ba68e82773f7 |\n| root_gb | 80 |\n| service | None |\n| state | building |\n| state_description | spawning |\n| tenant_id | 725 |\n| timestamp | 2015-04-22 21:43:29.940846 |\n| user_id | 945 |\n| vcpus | 2 |\n+--------------------+------------------------------------------+\n\n\n$ klugman http://stacktach3-api01.example.com:8000 events --name compute.instance.create.end\n+--------------------+------------------------------------------+\n| Property | Value |\n+--------------------+------------------------------------------+\n| _mark | 6547e |\n| disk_gb | 80 |\n| display_name | My_Display_Name |\n| ephemeral_gb | 0 |\n| event_type | compute.instance.create.end |\n| host | c-11-22-33-4 |\n| instance_flavor | 2GB Standard Instance |\n| instance_flavor_id | 4 |\n| instance_id | 0c30d4be-409d-dead-beef-6d8a3744e80f |\n| instance_type | 2GB Standard Instance |\n| launched_at | 2015-04-22 21:46:04 |\n| memory_mb | 2048 |\n| message | Success |\n| message_id | 51bd735f-9817-4940-9826-5b057bf51f70 |\n| os_architecture | x64 |\n| os_distro | com.microsoft.server |\n| os_version | 2012.0 |\n| rax_options | 4 |\n| request_id | req-108e129d-49fd-1213-8e93-3f5595fd4d6c |\n| root_gb | 80 |\n| service | compute |\n| state | active |\n| state_description | |\n| tenant_id | 3334 |\n| timestamp | 2015-04-22 21:46:05.066171 |\n| user_id | 3848 |\n| vcpus | 2 |\n+--------------------+------------------------------------------+\n\n\n$ klugman http://stacktach3-api01.example.com:8000 events --name compute.instance.create.end --count\n+----------+-------+\n| Property | Value |\n+----------+-------+\n| count | 10280 |\n+----------+-------+\n\n\n$ klugman http://stacktach3-api01.example.com:8000 events --msg_id 047d9d5c-9190-4b85-9963-35d4cd095d07\n+--------------------+------------------------------------------+\n| Property | Value |\n+--------------------+------------------------------------------+\n| disk_gb | 80 |\n| display_name | My_Display_Name |\n| ephemeral_gb | 0 |\n| event_type | compute.instance.create.end |\n| host | c-11-22-33-4 |\n| instance_flavor | 2GB Standard Instance |\n| instance_flavor_id | 4 |\n| instance_id | b3c1be31-0ebe-4d6d-9663-b617eabac421 |\n| instance_type | 2GB Standard Instance |\n| launched_at | 2015-04-22 18:02:03 |\n| memory_mb | 2048 |\n| message | Success |\n| message_id | 047d9d5c-9190-4b85-9963-35d4cd095d07 |\n| os_architecture | x64 |\n| os_distro | org.debian |\n| os_version | 7 |\n| rax_options | 0 |\n| request_id | req-597b08a3-faef-425a-8f63-b91abcb1e1dd |\n| root_gb | 80 |\n| service | compute |\n| state | active |\n| tenant_id | 3334 |\n| timestamp | 2015-04-22 21:46:05.066171 |\n| user_id | 3848 |\n| vcpus | 2 |\n+--------------------+------------------------------------------+\n\n```", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/StackTach/klugman", "keywords": "stacktach\nrest\napi\nclient\nklugman\nquincy\nopenstack", "license": "Apache-2", "maintainer": null, "maintainer_email": null, "name": "klugman", "package_url": "https://pypi.org/project/klugman/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/klugman/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/StackTach/klugman" }, "release_url": "https://pypi.org/project/klugman/0.5.dev25/", "requires_dist": null, "requires_python": null, "summary": "StackTach.v3 Client", "version": "0.5.dev25" }, "last_serial": 1548507, "releases": { "0.3.dev21": [ { "comment_text": "", "digests": { "md5": "7c2b4124d371331cfe9da519f7dfb208", "sha256": "bb10f4bb954e02d49295b19b9a8d6e4b49f1222a66705c15df7d9a6e01cee4ea" }, "downloads": -1, "filename": "klugman-0.3.dev21.tar.gz", "has_sig": false, "md5_digest": "7c2b4124d371331cfe9da519f7dfb208", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12215, "upload_time": "2015-03-20T17:41:54", "url": "https://files.pythonhosted.org/packages/a5/1a/bc007d166fbc206ebedb1b4f9657121da8977b88edda01a6b2df6bfcae1d/klugman-0.3.dev21.tar.gz" } ], "0.5.dev25": [ { "comment_text": "", "digests": { "md5": "c735d871c23b358dd99ef76ddaf7808c", "sha256": "634fa11dc31d8673767e3a03dc0aa053993d272bfd913de5d51574c905d94290" }, "downloads": -1, "filename": "klugman-0.5.dev25.tar.gz", "has_sig": false, "md5_digest": "c735d871c23b358dd99ef76ddaf7808c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14956, "upload_time": "2015-05-15T15:47:38", "url": "https://files.pythonhosted.org/packages/43/f8/2ae2a05e9f03809b3824ad3b3290e8c6b7e4426b83af2da3980c4db2875e/klugman-0.5.dev25.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c735d871c23b358dd99ef76ddaf7808c", "sha256": "634fa11dc31d8673767e3a03dc0aa053993d272bfd913de5d51574c905d94290" }, "downloads": -1, "filename": "klugman-0.5.dev25.tar.gz", "has_sig": false, "md5_digest": "c735d871c23b358dd99ef76ddaf7808c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14956, "upload_time": "2015-05-15T15:47:38", "url": "https://files.pythonhosted.org/packages/43/f8/2ae2a05e9f03809b3824ad3b3290e8c6b7e4426b83af2da3980c4db2875e/klugman-0.5.dev25.tar.gz" } ] }