From 97d68942abd217b4f05b38b70df80230ac608873 Mon Sep 17 00:00:00 2001 From: Ekko Chang Date: Tue, 3 Mar 2020 02:20:41 +0000 Subject: DL-Handler user guid Doc Issue-ID: DCAEGEN2-2028 Signed-off-by: Ekko Chang Change-Id: Id3a65a8442497e744040acaf40b241b5672f4c0b --- .../datalake-handler/images/adminui-dbs-edit.png | Bin 0 -> 839075 bytes .../datalake-handler/images/adminui-dbs.png | Bin 0 -> 756538 bytes .../images/adminui-design-edit.png | Bin 0 -> 967020 bytes .../datalake-handler/images/adminui-design.png | Bin 0 -> 722835 bytes .../datalake-handler/images/adminui-feeder.png | Bin 0 -> 694176 bytes .../datalake-handler/images/adminui-kafka-edit.png | Bin 0 -> 862153 bytes .../datalake-handler/images/adminui-kafka.png | Bin 0 -> 705207 bytes .../datalake-handler/images/adminui-tools.png | Bin 0 -> 708093 bytes .../images/adminui-topic-config.png | Bin 0 -> 865658 bytes .../images/adminui-topic-edit1.png | Bin 0 -> 922069 bytes .../images/adminui-topic-edit2.png | Bin 0 -> 783825 bytes .../images/adminui-topic-edit3.png | Bin 0 -> 860844 bytes .../datalake-handler/images/adminui-topic-new.png | Bin 0 -> 858316 bytes .../datalake-handler/images/adminui-topics.png | Bin 0 -> 759708 bytes .../services/datalake-handler/userguide.rst | 81 ++++++++++++++++++++- 15 files changed, 79 insertions(+), 2 deletions(-) create mode 100644 docs/sections/services/datalake-handler/images/adminui-dbs-edit.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-dbs.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-design-edit.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-design.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-feeder.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-kafka-edit.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-kafka.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-tools.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-topic-config.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-topic-edit1.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-topic-edit2.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-topic-edit3.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-topic-new.png create mode 100644 docs/sections/services/datalake-handler/images/adminui-topics.png diff --git a/docs/sections/services/datalake-handler/images/adminui-dbs-edit.png b/docs/sections/services/datalake-handler/images/adminui-dbs-edit.png new file mode 100644 index 00000000..017aaa7a Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-dbs-edit.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-dbs.png b/docs/sections/services/datalake-handler/images/adminui-dbs.png new file mode 100644 index 00000000..6c411a8f Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-dbs.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-design-edit.png b/docs/sections/services/datalake-handler/images/adminui-design-edit.png new file mode 100644 index 00000000..26019845 Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-design-edit.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-design.png b/docs/sections/services/datalake-handler/images/adminui-design.png new file mode 100644 index 00000000..b0904479 Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-design.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-feeder.png b/docs/sections/services/datalake-handler/images/adminui-feeder.png new file mode 100644 index 00000000..26adab2a Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-feeder.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-kafka-edit.png b/docs/sections/services/datalake-handler/images/adminui-kafka-edit.png new file mode 100644 index 00000000..b48e5128 Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-kafka-edit.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-kafka.png b/docs/sections/services/datalake-handler/images/adminui-kafka.png new file mode 100644 index 00000000..743fb1e6 Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-kafka.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-tools.png b/docs/sections/services/datalake-handler/images/adminui-tools.png new file mode 100644 index 00000000..18a1e18b Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-tools.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-config.png b/docs/sections/services/datalake-handler/images/adminui-topic-config.png new file mode 100644 index 00000000..d15f075c Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-topic-config.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-edit1.png b/docs/sections/services/datalake-handler/images/adminui-topic-edit1.png new file mode 100644 index 00000000..81212670 Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-topic-edit1.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-edit2.png b/docs/sections/services/datalake-handler/images/adminui-topic-edit2.png new file mode 100644 index 00000000..145b86d6 Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-topic-edit2.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-edit3.png b/docs/sections/services/datalake-handler/images/adminui-topic-edit3.png new file mode 100644 index 00000000..08cd6be5 Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-topic-edit3.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-topic-new.png b/docs/sections/services/datalake-handler/images/adminui-topic-new.png new file mode 100644 index 00000000..12f8948f Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-topic-new.png differ diff --git a/docs/sections/services/datalake-handler/images/adminui-topics.png b/docs/sections/services/datalake-handler/images/adminui-topics.png new file mode 100644 index 00000000..adb5696c Binary files /dev/null and b/docs/sections/services/datalake-handler/images/adminui-topics.png differ diff --git a/docs/sections/services/datalake-handler/userguide.rst b/docs/sections/services/datalake-handler/userguide.rst index 4a0957f5..b3be9491 100644 --- a/docs/sections/services/datalake-handler/userguide.rst +++ b/docs/sections/services/datalake-handler/userguide.rst @@ -1,4 +1,81 @@ Admin UI User Guide --------------------- - -To be filled. + +Introduction +~~~~~~~~ +DataLake Admin UI aims to provide a user-friendly dashboard to easily monitor and +manage DataLake configurations for the involved components, ONAP topics, databases, +and 3rd-party tools. Please refer to the link to access the Admin UI portal +via http://datalake-admin-ui:30479 + + +DataLake Feeder Management +****************** +.. image:: ./images/adminui-feeder.png +Click the "DataLake Feeder" on the menu bar, and the dashboard will show +the overview DataLake Feeder information, such as the numbers of topics. +Also, you can enable or disable DataLake Feeder process backend process +by using the toggle switch. + + +Kafka Management +****************** +.. image:: ./images/adminui-kafka.png +Click the "Kafka" on the menu bar, and it provides the kafka resource settings +including add, modify and delete in the page to fulfill your management demand. + +.. image:: ./images/adminui-kafka-edit.png +You can modify the kafka resource via clicking the card, +and click the plus button to add a new Kafka resource. +Then, you will need to fill the required information such as identifying name, +message router address and zookeeper address, and so on to build it up. + + +Topics Management +****************** +.. image:: ./images/adminui-topics.png +.. image:: ./images/adminui-topic-edit1.png +.. image:: ./images/adminui-topic-edit2.png +.. image:: ./images/adminui-topic-edit3.png +The Topic page lists down all the topics which you have been configured +by topic management. You can edit the topic setting via double click the specific row. +The setting includes DataLake feeder status - catch the topic or not, +data format, and the numbers of time to live for the topic. +And choose one or more Kafka items as topic resource +and define the databased to store topic info are necessary. + +.. image:: ./images/adminui-topic-config.png +For the default configuration of Topics, you can click the "Default configurations" button +to do the setting. When you add a new topic, these configurations will be filled into the form automatically. + +.. image:: ./images/adminui-topic-new.png +To add a new topic for the DataLake Feeder, you can click the "plus icon" button +to catch the data into the 3rd-party database. +Please be noted that only existing topics in the Kafka can be added. + + +Database Management +****************** +.. image:: ./images/adminui-dbs.png +.. image:: ./images/adminui-dbs-edit.png +In the Database Management page, it allows you to add, modify and delete the database resources +where the message from topics will be stored. +DataLake supports a bunch of databases including Couchbase DB, Apache Druid, Elasticsearch, HDFS, and MongoDB. + + +3rd-Party Tools Management +****************** +.. image:: ./images/adminui-tools.png +In the Tools page, it allows you to manage the resources of 3rd-party tools for data visualization. +Currently, DataLake supports two Tools which are Kibana and Apache Superset. + + +3rd-Party Design Tools Management +****************** +.. image:: ./images/adminui-design.png +.. image:: ./images/adminui-design-edit.png +After setting up the 3rd-party tools, you can import the template as the JSON, YAML or other formats +for data exploration, data visualization and dashboarding. DataLake supports Kibana dashboarding, +Kibana searching, Kibana visualization, Elasticsearch field mapping template, +and Apache Druid Kafka indexing service. + -- cgit 1.2.3-korg