docs/sections/services/datalake-handler/userguide.rst

   1 Admin UI User Guide
   2 ---------------------
   3
   4 Introduction
   5 ~~~~~~~~
   6 DataLake Admin UI aims to provide a user-friendly dashboard to easily monitor and
   7 manage DataLake configurations for the involved components, ONAP topics, databases,
   8 and 3rd-party tools. Please refer to the link to access the Admin UI portal
   9 via http://datalake-admin-ui:30479
  10
  11
  12 DataLake Feeder Management
  13 ******************
  14 .. image:: ./images/adminui-feeder.png
  15 Click the "DataLake Feeder" on the menu bar, and the dashboard will show
  16 the overview DataLake Feeder information, such as the numbers of topics.
  17 Also, you can enable or disable DataLake Feeder process backend process
  18 by using the toggle switch.
  19
  20
  21 Kafka Management
  22 ******************
  23 .. image:: ./images/adminui-kafka.png
  24 Click the "Kafka" on the menu bar, and it provides the kafka resource settings
  25 including add, modify and delete in the page to fulfill your management demand.
  26
  27 .. image:: ./images/adminui-kafka-edit.png
  28 You can modify the kafka resource via clicking the card,
  29 and click the plus button to add a new Kafka resource.
  30 Then, you will need to fill the required information such as identifying name,
  31 message router address and zookeeper address, and so on to build it up.
  32
  33
  34 Topics Management
  35 ******************
  36 .. image:: ./images/adminui-topics.png
  37 .. image:: ./images/adminui-topic-edit1.png
  38 .. image:: ./images/adminui-topic-edit2.png
  39 .. image:: ./images/adminui-topic-edit3.png
  40 The Topic page lists down all the topics which you have been configured
  41 by topic management. You can edit the topic setting via double click the specific row.
  42 The setting includes DataLake feeder status - catch the topic or not,
  43 data format, and the numbers of time to live for the topic.
  44 And choose one or more Kafka items as topic resource
  45 and define the databased to store topic info are necessary.
  46
  47 .. image:: ./images/adminui-topic-config.png
  48 For the default configuration of Topics, you can click the "Default configurations" button
  49 to do the setting. When you add a new topic, these configurations will be filled into the form automatically.
  50
  51 .. image:: ./images/adminui-topic-new.png
  52 To add a new topic for the DataLake Feeder, you can click the "plus icon" button
  53 to catch the data into the 3rd-party database.
  54 Please be noted that only existing topics in the Kafka can be added.
  55
  56
  57 Database Management
  58 ******************
  59 .. image:: ./images/adminui-dbs.png
  60 .. image:: ./images/adminui-dbs-edit.png
  61 In the Database Management page, it allows you to add, modify and delete the database resources
  62 where the message from topics will be stored.
  63 DataLake supports a bunch of databases including Couchbase DB, Apache Druid, Elasticsearch, HDFS, and MongoDB.
  64
  65
  66 3rd-Party Tools Management
  67 ******************
  68 .. image:: ./images/adminui-tools.png
  69 In the Tools page, it allows you to manage the resources of 3rd-party tools for data visualization.
  70 Currently, DataLake supports two Tools which are Kibana and Apache Superset.
  71
  72
  73 3rd-Party Design Tools Management
  74 ******************
  75 .. image:: ./images/adminui-design.png
  76 .. image:: ./images/adminui-design-edit.png
  77 After setting up the 3rd-party tools, you can import the template as the JSON, YAML or other formats
  78 for data exploration, data visualization and dashboarding. DataLake supports Kibana dashboarding,
  79 Kibana searching, Kibana visualization, Elasticsearch field mapping template,
  80 and Apache Druid Kafka indexing service.
  81