Skip to content

Commit bf7c298

Browse files
authored
Update README and CHANGELOG (#59)
1 parent a594aa2 commit bf7c298

File tree

3 files changed

+40
-80
lines changed

3 files changed

+40
-80
lines changed

CHANGELOG.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,20 @@
11
# Change Log
22

3-
## 1.2.0 (IN PROGRESS)
3+
## 1.2.0 (2021-05-11)
44

55
### Features / Enhancements
66

7-
- Update Grafana dependencies to 7.5.4
7+
- Upgrade Grafana dependencies 7.5.4 #53
8+
- Update Docker workflow #52
9+
- Update Docker token and add Master build #54
10+
- Add RefId to Query as mandatory for the upcoming release #55
11+
- Update RedisGears Script Editor Execution modes #57
12+
- Update Dashboards to version 7.5.5 #58
13+
14+
### Bug fixes
15+
16+
- Add default Color Mode Id for older releases (7.2.X) #49
17+
- Fix Latency below zero calculation #56
818

919
## v1.1.0 (2021-02-07)
1020

README.md

Lines changed: 28 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -8,124 +8,74 @@
88
![CI](https://github.com/RedisGrafana/grafana-redis-app/workflows/CI/badge.svg)
99
![Docker](https://github.com/RedisGrafana/grafana-redis-app/workflows/Docker/badge.svg)
1010
[![codecov](https://codecov.io/gh/RedisGrafana/grafana-redis-app/branch/master/graph/badge.svg?token=15SIRGU8SX)](https://codecov.io/gh/RedisGrafana/grafana-redis-app)
11+
[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/RedisGrafana/grafana-redis-app.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/RedisGrafana/grafana-redis-app/context:javascript)
1112

1213
## Summary
1314

1415
- [**Introduction**](#introduction)
15-
- [**Dashboards**](#dashboards)
16-
- [**Custom panels**](#custom-panels)
1716
- [**Getting Started**](#getting-started)
17+
- [**Documentation**](#documentation)
18+
- [**Development**](#development)
1819
- [**Feedback**](#feedback)
1920
- [**Contributing**](#contributing)
2021
- [**License**](#license)
2122

2223
## Introduction
2324

24-
### What is the Redis Application for Grafana?
25+
The Redis Application is a plug-in for Grafana that provides application pages, custom panels, and dashboards for [Redis Data Source](https://grafana.com/grafana/plugins/redis-datasource).
2526

26-
The Redis Application, is a plug-in for Grafana that provides application pages and custom panels for [Redis Data Source](https://grafana.com/grafana/plugins/redis-datasource):
27+
### Custom Panels
2728

28-
- [**Command line interface (CLI)**](#redis-cli-panel)
29-
- [**Command Latency (graph and table)**](#latency-panel)
30-
- [**Keys consuming a lot of memory**](#keys-consuming-a-lot-of-memory-panel)
31-
- [**Redis Gears**](#redis-gears-panel)
29+
- [Command-line interface (CLI)](https://redisgrafana.github.io/redis-app/panels/redis-cli-panel/)
30+
- [Command Latency (graph and table)](https://redisgrafana.github.io/redis-app/panels/redis-latency-panel/)
31+
- [Keys consuming a lot of memory](https://redisgrafana.github.io/redis-app/panels/redis-keys-panel/)
32+
- [RedisGears Script Editor](https://redisgrafana.github.io/redis-app/panels/redis-gears-panel/)
3233

33-
### What Grafana version is supported?
34+
### Dashboards
3435

35-
Only Grafana 7.1 and later with a new plug-in platform supported.
36+
- [Redis CLI](https://redisgrafana.github.io/redis-app/dashboards/cli/)
37+
- [Redis Overview](https://redisgrafana.github.io/redis-app/dashboards/overview/)
38+
- [RedisGears](https://redisgrafana.github.io/redis-app/dashboards/redis-gears/)
3639

37-
## Dashboards
38-
39-
Redis application plug-in includes Redis Overview, CLI and RedisGears dashboards. All dashboard are available from Application's icon in the left side menu.
40+
All dashboards are available from the application's icon in the left side menu.
4041

4142
![Redis-CLI-Dashboards](https://raw.githubusercontent.com/RedisGrafana/grafana-redis-app/master/src/img/redis-cli-dashboard.png)
4243

43-
Redis CLI dashboard combines Redis CLI with streaming panels to observe Redis database in real-time.
44-
45-
## Custom Panels
46-
47-
## Redis CLI panel
48-
49-
This panel provides [Redis command line interface](https://redis.io/topics/rediscli) that allows to send commands to Redis, and read the replies sent by the server, directly from the Grafana.
50-
51-
![CLI](https://raw.githubusercontent.com/RedisGrafana/grafana-redis-app/master/src/img/redis-cli-panel.png)
52-
53-
## Latency panel
54-
55-
Redis is often used in the context of demanding use cases, where it serves a large number of queries per second per instance, and at the same time, there are very strict latency requirements both for the average response time and for the worst case latency.
56-
57-
![Latency-Graph](https://raw.githubusercontent.com/RedisGrafana/grafana-redis-app/master/src/img/redis-latency-panel-graph.png)
58-
59-
This panel provides commands's latency based on [INFO COMMANDSTATS](https://redis.io/commands/info). Information is provide as chart and table.
60-
61-
![Latency-Table](https://raw.githubusercontent.com/RedisGrafana/grafana-redis-app/master/src/img/redis-latency-panel-table.png)
62-
63-
## Keys consuming a lot of memory panel
64-
65-
Do you want to know which keys consume a lot of memory in your Redis database? This panel is based on [SCAN](https://redis.io/commands/scan) and [MEMORY USAGE](https://redis.io/commands/memory-usage) commands to scan keys and sort results based on memory usage in the table format.
66-
67-
![Keys](https://raw.githubusercontent.com/RedisGrafana/grafana-redis-app/master/src/img/redis-keys-panel.png)
68-
69-
Please use this command in OFF-PEAK as it cause latency increase. Interval and count for SCAN command is configurable to keep latency under control.
70-
71-
## Redis Gears panel
44+
### Requirements
7245

73-
[RedisGears](https://oss.redislabs.com/redisgears/) is a dynamic framework that enables developers to write and execute functions that implement data flows in Redis, while abstracting away the data’s distribution and deployment. This panel support Python syntax and allows to execute functions in blocking and non-blocking mode.
74-
75-
![RedisGears-Dashboard](https://raw.githubusercontent.com/RedisGrafana/grafana-redis-app/master/src/img/redis-gears-dashboard.png)
46+
Only **Grafana 7.1+** with a new Backend plug-in platform supports Redis plug-ins.
7647

7748
## Getting Started
7849

79-
### Install using `grafana-cli`
80-
81-
Use the `grafana-cli` tool to install from the commandline:
50+
Use the `grafana-cli` tool to install from the command line:
8251

8352
```bash
8453
grafana-cli plugins install redis-app
8554
```
8655

87-
### Run using `docker`
88-
89-
```bash
90-
docker run -d -p 3000:3000 --name=grafana -e "GF_INSTALL_PLUGINS=redis-app" grafana/grafana
91-
```
92-
93-
### Run using `docker` the nightly build (UNSTABLE)
94-
95-
Supported platforms are:
96-
97-
- linux/amd64
98-
- linux/arm64
99-
- linux/arm
56+
For Docker instructions and installation without Internet access, follow the [Quickstart](https://redisgrafana.github.io/quickstart/) page.
10057

101-
```bash
102-
docker run -d -p 3000:3000 --name=redis-app ghcr.io/redisgrafana/redis-app:latest
103-
```
58+
### Open Grafana and enable Redis Application plug-in
10459

105-
### Run using `docker-compose` for development
60+
Open Grafana in your browser, enable Redis Application plug-in, and configure Redis Data Sources.
10661

107-
Application plug-in and Redis Data Source have to be built following [BUILD](https://github.com/RedisGrafana/grafana-redis-app/blob/master/BUILD.md) instructions before starting.
62+
![Enable](https://raw.githubusercontent.com/RedisGrafana/grafana-redis-app/master/src/img/enable.png)
10863

109-
Project provides `docker-compose/dev.yml` to start Redis with Redis Labs modules and Grafana 7.0.
64+
## Documentation
11065

111-
```bash
112-
docker-compose -f docker-compose/dev.yml up
113-
```
114-
115-
### Open Grafana and enable Redis Application plug-in
66+
Take a look at the [Documentation](https://redisgrafana.github.io/redis-app/overview/) to learn more about the Redis Application plug-in, Redis Data Source, provided dashboards, and custom panels.
11667

117-
Open Grafana in your browser, enable Redis Application plug-in and configure Redis Data Sources.
68+
## Development
11869

119-
## Learn more
70+
[Developing Redis Application plug-in](https://redisgrafana.github.io/development/redis-app/) page provides instructions on building the application.
12071

121-
- [Real-time observability with Redis and Grafana](https://grafana.com/go/observabilitycon/real-time-observability-with-redis-and-grafana/)
122-
- [Redis Data Source](https://grafana.com/grafana/plugins/redis-datasource)
72+
Are you interested in the latest features and updates? Start nightly built [Docker image for Redis Application plug-in](https://redisgrafana.github.io/development/images/).
12373

12474
## Feedback
12575

126-
We love to hear from users, developers and the whole community interested by this plug-in. These are various ways to get in touch with us:
76+
We love to hear from users, developers, and the whole community interested in this plug-in. These are various ways to get in touch with us:
12777

128-
- Ask a question, request a new feature and file a bug with [GitHub issues](https://github.com/RedisGrafana/grafana-redis-app/issues/new/choose).
78+
- Ask a question, request a new feature, and file a bug with [GitHub issues](https://github.com/RedisGrafana/grafana-redis-app/issues/new/choose).
12979
- Star the repository to show your support.
13080

13181
## Contributing

src/img/enable.png

94.5 KB
Loading

0 commit comments

Comments
 (0)