https://github.com/cumulocity-iot/iot-cumulocity-events-graph
The Event Graph Widget Plugin displays event occurrence in a timeline chart, using echarts profiling example approach. For the different texts a color can be chosen. (Currently only works in a device dashboard!)
https://github.com/cumulocity-iot/iot-cumulocity-events-graph
chart cumulocity-iot cumulocity-package cumulocity-plugin cumulocity-profserv-package cumulocity-widget events iot-analytics microfrontend plugin
Last synced: 6 months ago
JSON representation
The Event Graph Widget Plugin displays event occurrence in a timeline chart, using echarts profiling example approach. For the different texts a color can be chosen. (Currently only works in a device dashboard!)
- Host: GitHub
- URL: https://github.com/cumulocity-iot/iot-cumulocity-events-graph
- Owner: Cumulocity-IoT
- License: apache-2.0
- Created: 2023-08-17T08:31:18.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-11-22T10:25:39.000Z (over 1 year ago)
- Last Synced: 2024-12-20T17:16:01.509Z (6 months ago)
- Topics: chart, cumulocity-iot, cumulocity-package, cumulocity-plugin, cumulocity-profserv-package, cumulocity-widget, events, iot-analytics, microfrontend, plugin
- Language: TypeScript
- Homepage: https://echarts.apache.org/examples/en/editor.html?c=custom-profile
- Size: 1.81 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IoT Cumulocity Events Graph package
## Events Graph widget plugin
Show event occurence in a timeline chart, using echarts profiling example approach (see https://echarts.apache.org/examples/en/editor.html?c=custom-profile). For the different texts a color can be chosen. (Currently only works in a device dashboard!)
## Features
Shows "duration" of every event by assuming that a state is finished once the next state starts - an event always ends with the submission of the next event. The chart shows a view of the past x hours and helps visualizing the state changes for a specific event type.
* choose color for different states
* select timeframe (max. 24 hours in the past)
* states can be deselected in the legend
* chart is zoomable
## Sample images
Easily check which events occured when
The chart can be zoomed
Interactive legend
## Limitations
* only works for single devices
* only works for single event type, visualising the different event texts as bars
* no realtime
* no dashboard date integration
## Versions
2.0.0 - WebSDK v. 1017
**How to start**
Change the target tenant and application you want to run this plugin on in the `package.json`.
```
c8ycli server -u https://{{your-tenant}}.cumulocity.com/ --shell {{cockpit}}
```
Keep in mind that this plugin needs to have an app (e.g. cockpit) running with at least the same version as this plugin. if your tenant contains an older version, use the c8ycli to create a cockpit clone running with at least v 1017! Upload this clone to the target tenant and reference this name in the --shell command.
The widget plugin can be locally tested via the start script:
```
npm start
```
In the Module Federation terminology, `widget` plugin is called `remote` and the `cokpit` is called `shell`. Modules provided by this `widget` will be loaded by the `cockpit` application at the runtime. This plugin provides a basic custom widget that can be accessed through the `Add widget` menu.
> Note that the `--shell` flag creates a proxy to the cockpit application and provides` LayeredMapWidgetModule` as an `remote` via URL options.
Also deploying needs no special handling and can be simply done via `npm run deploy`. As soon as the application has exports it will be uploaded as a plugin.
## Useful links
📘 Explore the Knowledge Base
Dive into a wealth of Cumulocity IoT tutorials and articles in our [Tech Community Knowledge Base](https://tech.forums.softwareag.com/tags/c/knowledge-base/6/cumulocity-iot).
💡 Get Expert Answers
Stuck or just curious? Ask the Cumulocity IoT experts directly on our [Forum](https://tech.forums.softwareag.com/tags/c/forum/1/Cumulocity-IoT).
🚀 Try Cumulocity IoT
See Cumulocity IoT in action with a [Free Trial](https://techcommunity.softwareag.com/en_en/downloads.html).
✍️ Share Your Feedback
Your input drives our innovation. If you find a bug, please create an issue in the repository. If you’d like to share your ideas or feedback, please post them [here](https://tech.forums.softwareag.com/c/feedback/2).
More to discover
* [How to install a Microfrontend Plugin on a tenant and use it in an app?](https://tech.forums.softwareag.com/t/how-to-install-a-microfrontend-plugin-on-a-tenant-and-use-it-in-an-app/268981)
* [Cumulocity IoT Web Development Tutorial - Part 1: Start your journey](https://tech.forums.softwareag.com/t/cumulocity-iot-web-development-tutorial-part-1-start-your-journey/259613)
* [The power of micro frontends – How to dynamically extend Cumulocity IoT Frontends](https://tech.forums.softwareag.com/t/the-power-of-micro-frontends-how-to-dynamically-extend-cumulocity-iot-frontends/266665)
------------------------------
These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.