(DI-1711) End user documentation

This manual and its content is copyright of DataVard GmbH – © DataVard 2017. All rights reserved.

Any redistribution or reproduction of part or all of the contents in any form is prohibited other than the following:

  • You may print or download to a local hard disk extracts for your personal and non-commercial use only.
  • You may copy the content to individual third parties for their personal use, but only if you acknowledge this document as the source of the material.

You may not, except with our express written permission, distribute or commercially exploit the content. Nor may you transmit it or store it in any website or other form of electronic retrieval system.

SAP, ABAP, SAP Business Suite, SAP ERP, SAP Customer Relationship Management (SAP CRM), SAP ERP Human Capital Management (SAP ERP HCM), SAP ERP Operations, SAP ERP Financials, SAP Product Lifecycle Management (SAP PLM), SAP Supplier Relationship Management (SAP SRM), SAP Supply Chain Management (SAP SCM), SAP Business One, SAP Business All-in-One, SAP NetWeaver Business Intelligence (SAP NetWeaver BI), SAP NetWeaver Master Data Management, SAP NetWeaver, SAP Solution Manager, SAP Exchange Infrastructure (SAP NetWeaver XI) SAP Business Information Warehouse (SAP BW), SAP Strategic Enterprise Management (SAP SEM), SAP R/3, SAP R/3 Enterprise, SAP Business ByDesign, SAP BusinessObjects GRC Global Trade Services, SAP GTS are the trademarks or registered trademarks of SAP AG in Germany and in several other countries.


Overview

Datavard Insights is application that collect, index and monitor machine data (mainly logs) from any source. 

Architecture

Application architecture consist of three main parts. Core part of application is SAP HANA XS application that stores store and index content of collected files. XS application is providing HTTP services that allows external File indexing agents to register upload files and their contents. File indexing agent is reading and parsing text files into smaller chunks that represent separate events or logs that was written into file. These chunks then agent uploads to XS application through HTTP interface. Last part is actual user interface application based on HTML5 and SAPUI5 library. Web application is using services of XS application for searching through uploaded file contents.


Installation

Prerequisites

  • You have our own account on SAP Cloud platform

    • You have HANA database connected to your account 

  • You have obtained installation package that includes

    • Delivery unit of HANA XS

    • SAPUI5 application

  • Application requires minimum version of following components

Component

Minimum required version

SAPUI5 library

1.38

HANA Database

1.00.121.00.1466466057


For step by step installation follow installation guide.

User interface

Application provides intuitive user interface for full text search in parsed log files. Results contain following information. 

  • Origin

    • Identification of file location

  • File name

    • Full patch of file in local file system

  • Time stamp

    • Date and time of log content

  • File Content

    • Log Content itself

Layout of application is divided into tree sections. Top section contains searching and filtering controls, middle section shows number of results by date and bottom section shows actual results.

Filtering controls

Main function of Datavard Insights is to find and further analyze logs from multiple sources. Filter control helps user to find required results in file content. User is able to filter on all result properties. Following screenshots display which control is filter with result information.

Main search input field

As previous diagram reveals, main search bar is used for filtering file content based on given key word. User needs to confirm searched word either by clicking to magnifier icon  or pressing ENTER on keyboard.

Date range selection

Date range selects only file content that was created in chosen time range. User has the possibility to chose from following options:

  • Hour

    • current date and time minus 1 hour

  • 6 Hours

    • current date and time minus 6 hours

  • Day

    • default option

    • current date and time minus 24 hours

  • Week

    • current date and time - 7 days

  • Custom

    • custom defined date time range (max date and time that can be set is restricted to current date and time)

Additional filters

Sometimes user wants to pick certain file location or file itself, where the search engine will look for key word.

Mentioned properties can be filtered by using patterns. If you for example chose Origin and type 'DVD' to input field Pattern it will find all Origins that contains 'DVD'.

Result distribution chart

Once user gets search results distribution column chart shows, what is a distribution of results per particular day. Chart displays only days where at least 1 result was found for specified date range.

Results

Based on filter settings, results are displayed in form of table with mentioned columns in chronological order (ascending).

If search contains more than 20 results, table will show only first 20 entries. If it is necessary to show more records, user can click on 'More' option that loads another 20 rows. This option is visible in the end of table.

Troubleshooting

If you experience issue or behavior that wasn't described, please contact our support. Check support document.