Skip to content

Commit

Permalink
Merge pull request #150 from metrico/docs-update
Browse files Browse the repository at this point in the history
Docs update
  • Loading branch information
jacovinus authored Dec 12, 2022
2 parents 24b41fc + ee7f5a1 commit 03e026e
Show file tree
Hide file tree
Showing 3 changed files with 52 additions and 12 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/npm_build_test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ jobs:
tag-prefix: 'v'
skip-tag: true
if: github.ref == 'ref/head/beta'
tag-suffix: 'beta'
tag-suffix: '-beta'

env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Expand Down Expand Up @@ -66,7 +66,7 @@ jobs:
release_config: |
dist.zip
tag_name: ${{steps.version.outputs.newTag}}
release_name: cloki-view-${{steps.version.outputs.newTag}}
release_name: qryn-view-${{steps.version.outputs.newTag}}
draft: false
prerelease: false
overwrite: true
Expand Down
2 changes: 1 addition & 1 deletion BUILD.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,5 +54,5 @@ will serve by default the UI on ``http://localhost:3000``
- ``API_URL`` default: ``http://localhost:3100``

```bash
~/$ HOST=localhost PORT=8080 API_URL=http://cloki-host:3100 npm start
~/$ HOST=localhost PORT=8080 API_URL=http://qryn-host:3100 npm start
```
58 changes: 49 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

# :eye: qryn view

*qryn-view* is a smart and minimal LOgQL API data explorer developed in React/JS and designed for [qryn](https://cloki.org)
*qryn-view* is a smart and minimal LogQl, Metrics, Traces and Flux API data explorer developed in React/JS and designed for [qryn](https://qryn.dev)

![qryn-view-demo](https://user-images.githubusercontent.com/1423657/200136242-f4133229-ee7c-45e0-8228-8734cf56140a.gif)

Expand Down Expand Up @@ -43,6 +43,45 @@
------------
### Usage



**Local development:**

Clone Repo

```bash
git clone https://github.com/metrico/qryn-view
```
Install packages
```bash
npm install
```
---

**Local Build:**

Build local clone
```bash
npm run build
```
Install Serve (npm serve)
```bash
sudo npm i -g serve

serve -s build
```
---

**Releases**

check our [Qryn View Releases](https://github.com/metrico/qryn-view/releases)


---




_Use the [public client](https://view.cloki.org) _(no data goes through the server)_ or [build](BUILD.md) and run your own instance_

#### Environment Variables:
Expand All @@ -53,18 +92,16 @@ _Use the [public client](https://view.cloki.org) _(no data goes through the serv

##### Example
```bash
~/$ HOST=localhost PORT=8080 API_URL=http://cloki-host:3100 npm start
~/$ HOST=localhost PORT=8080 API_URL=http://qryn-host:3100 npm start
```
------------
##### URL Parameters
_cLoki-view can be controlled through URL parameters__

| param | description | default |
|-------|-------------|---------|
| `apiUrl` | _LogQL API URL_ | http://localhost:3100 |
| `start` | _timestamp Ns_ | now |
| `stop` | _timestamp Ns_ | |
| `step` | _query step_ | 5 |
| `isEmbed` | _embed mode_ | false |
| `theme` | _application theme_ | dark |
| `left` | _left panel queries details_ | |
Expand All @@ -73,13 +110,16 @@ _cLoki-view can be controlled through URL parameters__

------------

#### Query Data (logql) inside left or right panel
#### Query Data (logql, metrics, traces, flux) inside left or right panel
_JSON stringifyed and URL encoded_

- *id*: query ID
- *idRef* Title for a query
- *expr* query expression
- *limit* query limit
- *id*: - query ID
- *idRef* - Title for a query
- *expr* - query expression (neeeds to be URL encoded)
- *limit* - query limit
- *dataSourceType* - 'logs', 'metrics', 'traces', 'flux'.
- *dataSourceURL* - the datasource API URL.
- *dataSourceId* - Data Source Id inside Data Sources Setting

------------

Expand Down

0 comments on commit 03e026e

Please sign in to comment.