... | @@ -128,23 +128,7 @@ One of easily missed features of Stork is its dashboard. Make sure you click on |
... | @@ -128,23 +128,7 @@ One of easily missed features of Stork is its dashboard. Make sure you click on |
|
|
|
|
|
The list of subnets shows top 5 subnets with highest pool utilization. There's a list of events on the right hand side. If you configured Grafana, you will see links to Grafana to inspect historic values for subnets and how they changed over time.
|
|
The list of subnets shows top 5 subnets with highest pool utilization. There's a list of events on the right hand side. If you configured Grafana, you will see links to Grafana to inspect historic values for subnets and how they changed over time.
|
|
|
|
|
|
## 15. Grafana
|
|
## 15. DHCP address pool utilization
|
|
|
|
|
|
An early Grafana integration was introduced in 0.5. In 0.9, you can go to `Configuration` and `Settings` and set up the link to your Grafana. In case of demo, type in `http://localhost:3000` (if running the demo locally) or `http://stork.lab.isc.org:3000` (if using on stork.lab). Go to http://localhost:3000 or http://stork.lab.isc.org:3000 and log in using admin/admin credentials. Please don't change the password, so the next person viewing the demo can take a look, too.
|
|
|
|
|
|
|
|
There are two dashboards. One for Kea and another one for BIND 9.
|
|
|
|
|
|
|
|
**Kea**
|
|
|
|
|
|
|
|
Click on Home and then Stork Kea DHCPv4 dashboard. You have plenty of statistics being shown here. Make sure to use the traffic generator, otherwise you'll see boring zeros all the time. Note the pool utilization with two thresholds (80% and 90%) set up.
|
|
|
|
|
|
|
|
**BIND 9**
|
|
|
|
|
|
|
|
We're currently using third party exporter together with a Stork embedded exporter. If you don't see the BIND dashboard, you need to add it yourself. This is a limitation of 0.6 that will be improved in 0.7. You need to get the BIND dashboard (a single JSON file) from here: https://gitlab.isc.org/isc-projects/stork/-/tree/master/grafana. Go to Grafana homepage (http://stork.lab.isc.org:3000), click `Home`, then `Import dashboard`, then `Upload .json file` and upload it. Alternatively, you can paste this link `https://gitlab.isc.org/isc-projects/stork/-/raw/master/grafana/bind9-resolver.json` there.
|
|
|
|
|
|
|
|
Click on Home and then Stork Bind DNS dashboard. There are some generic statistics, as well as the Cache Hit Ratio/Hit/Miss statistics provided by Stork. More are coming in future Stork releases.
|
|
|
|
|
|
|
|
## 16. DHCP address pool utilization
|
|
|
|
|
|
|
|
Open a new tab in your browser and connect to http://localhost:5000 (if running locally) or to http://stork.lab.isc.org:5000 to take a look at the traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate actual networks. It's a bit simple, but sufficient enough to generate traffic. It retrieves list of subnets known by Stork and enables to generate traffic for each subnet. You may want to experiment with it. Things to play with it:
|
|
Open a new tab in your browser and connect to http://localhost:5000 (if running locally) or to http://stork.lab.isc.org:5000 to take a look at the traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate actual networks. It's a bit simple, but sufficient enough to generate traffic. It retrieves list of subnets known by Stork and enables to generate traffic for each subnet. You may want to experiment with it. Things to play with it:
|
|
|
|
|
... | @@ -162,10 +146,26 @@ With a little bit of juggling around, you can see something like this: |
... | @@ -162,10 +146,26 @@ With a little bit of juggling around, you can see something like this: |
|
|
|
|
|
Make sure you take a look at the shared networks, too!
|
|
Make sure you take a look at the shared networks, too!
|
|
|
|
|
|
## 17. DNS traffic
|
|
## 16. DNS traffic
|
|
|
|
|
|
Open a new tab in your browser and connect to the Stork Environment Simulator on http://localhost:5000 (if running locally) or http://stork.lab.isc.org:5000 to take a look at the DNS traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate some traffic. It retrieves the DNS servers known by stork and enables to generate traffic to it. You can send a simple query with `Dig` or start a query stream with the `Start` button. This is quite basic and may be extended in the future with the option to query different names, replay a pcap, and emulate different clients. Go ahead and experiment. Once you got some traffic, go to Grafana and see the BIND dashboard.
|
|
Open a new tab in your browser and connect to the Stork Environment Simulator on http://localhost:5000 (if running locally) or http://stork.lab.isc.org:5000 to take a look at the DNS traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate some traffic. It retrieves the DNS servers known by stork and enables to generate traffic to it. You can send a simple query with `Dig` or start a query stream with the `Start` button. This is quite basic and may be extended in the future with the option to query different names, replay a pcap, and emulate different clients. Go ahead and experiment. Once you got some traffic, go to Grafana and see the BIND dashboard.
|
|
|
|
|
|
|
|
## 17. Grafana
|
|
|
|
|
|
|
|
An early Grafana integration was introduced in 0.5. In 0.9, you can go to `Configuration` and `Settings` and set up the link to your Grafana. In case of demo, type in `http://localhost:3000` (if running the demo locally) or `http://stork.lab.isc.org:3000` (if using on stork.lab). Go to http://localhost:3000 or http://stork.lab.isc.org:3000 and log in using admin/admin credentials. Please don't change the password, so the next person viewing the demo can take a look, too.
|
|
|
|
|
|
|
|
There are two dashboards. One for Kea and another one for BIND 9.
|
|
|
|
|
|
|
|
**Kea**
|
|
|
|
|
|
|
|
Click on Home and then Stork Kea DHCPv4 dashboard. You have plenty of statistics being shown here. Make sure to use the traffic generator, otherwise you'll see boring zeros all the time. Note the pool utilization with two thresholds (80% and 90%) set up.
|
|
|
|
|
|
|
|
**BIND 9**
|
|
|
|
|
|
|
|
For Kea the dashboard for Grafana was already preconfigured. In case of BIND 9 it needs to be manually import. The dashboard definition is available here: https://gitlab.isc.org/isc-projects/stork/-/tree/master/grafana. Now go to Grafana homepage (http://stork.lab.isc.org:3000), click `Home`, then `Import dashboard`, then `Upload .json file` and upload it. Alternatively, you can paste this link `https://gitlab.isc.org/isc-projects/stork/-/raw/master/grafana/bind9-resolver.json` there.
|
|
|
|
|
|
|
|
Click on Home and then Stork Bind DNS dashboard. There are some generic statistics, as well as the Cache Hit Ratio/Hit/Miss statistics provided by Stork. More are coming in future Stork releases.
|
|
|
|
|
|
## 18. Events
|
|
## 18. Events
|
|
|
|
|
|
Stork records various events in the system. There are several places where you can observe events;
|
|
Stork records various events in the system. There are several places where you can observe events;
|
... | | ... | |