Fortinet white logo
Fortinet white logo

Administration Guide

Creating datasets

Creating datasets

FortiAnalyzer datasets are collections of data from logs for monitored devices. Charts and macros reference datasets. When you generate a report, the datasets populate the charts and macros to provide data for the report.

FortiAnalyzer has many predefined datasets that you can use right away. You can also create your own custom datasets.

To create a new dataset:
  1. If using ADOMs, ensure that you are in the correct ADOM.
  2. Go to Reports > Report Definitions > Datasets, and click Create New.
  3. Provide the required information for the new dataset.

    Name

    Enter a name for the dataset.

    Log Type

    Select a log type from the dropdown list. Below is a list of the available log types based on device.

    • FortiGate: Application, Intrusion Prevention, Content , Data Leak Prevention, DNS, Email Filter, Event, System Event, Security Event, Traffic, File Filter, GTP, Vulnerability Scan, Protocol, SSH, SSL, Antivirus, VoIP, Web Application Firewall, Web Filter, Local Event.
    • FortiMail: Email Filter, Event, History, and Antivirus.
    • FortiAnalyer: Application, Event, and Local Event.
    • FortiWeb: Application Attack Prevention, Event, and Traffic.
    • FortiCache: Application, Intrusion Prevention, Content , Data Leak Prevention, Email Filter, Event, Vulnerability Scan, Traffic, Antivirus, VoIP, and Web Filter.
    • FortiClient: System Event, Security Event, Traffic.
    • Syslog: Syslog.
    • FortiManager: Applicationand Event.
    • FortiSandbox: Event, Vulnerability Scan, and Antivirus.
    • FortiDDoS: Intrusion Prevention and Event.
    • FortiAuthenticator: Event.
    • FortiProxy: Application, Intrusion Prevention, Content , Data Leak Prevention, DNS, Email Filter, Event, File Filter, Vulnerability Scan, Protocol, SSH, SSL, Traffic, Antivirus, VoIP, and Web Filter.
    • FortiNAC: Asset and Event.
    • FortiFirewall: DNS, Event, File Filter, GTP, SSH, SSL, and Traffic.
    • FortiDeceptor: Event.
    • FortiSOAR: Event
    • FortiAI: Attack and Event.
    • Fabric: Normalized.

    Query

    Enter the SQL query used for the dataset. An easy way to build a custom query is to copy and modify a predefined dataset's query.

    Variables

    Click the Add button to add variable, expression, and description information.

    If added, the expression for the variable will be used when configuring filters for reports that use this dataset. For example, if Variable = User (user) and Expression = coalesce(nullifna(`user`), ipstr(`srcip`)), then the expression will be used when User (user) is selected as the Log Field in a report's filter. See Filtering report output.

    Test query with specified devices and time period

    Time Period

    Use the dropdown list to select a time period. When selecting Custom, enter the start date and time, and the end date and time.

    Devices

    Select All Devices or Specify to select specific devices to run the SQL query against. Click the Select Device button to add multiple devices to the query.

    Test

    Click to test the SQL query before saving the dataset configuration.

  4. Click Test.

    The query results are displayed. If the query is not successful, an error message appears in the Test Result pane.

  5. Click OK.

Creating datasets

Creating datasets

FortiAnalyzer datasets are collections of data from logs for monitored devices. Charts and macros reference datasets. When you generate a report, the datasets populate the charts and macros to provide data for the report.

FortiAnalyzer has many predefined datasets that you can use right away. You can also create your own custom datasets.

To create a new dataset:
  1. If using ADOMs, ensure that you are in the correct ADOM.
  2. Go to Reports > Report Definitions > Datasets, and click Create New.
  3. Provide the required information for the new dataset.

    Name

    Enter a name for the dataset.

    Log Type

    Select a log type from the dropdown list. Below is a list of the available log types based on device.

    • FortiGate: Application, Intrusion Prevention, Content , Data Leak Prevention, DNS, Email Filter, Event, System Event, Security Event, Traffic, File Filter, GTP, Vulnerability Scan, Protocol, SSH, SSL, Antivirus, VoIP, Web Application Firewall, Web Filter, Local Event.
    • FortiMail: Email Filter, Event, History, and Antivirus.
    • FortiAnalyer: Application, Event, and Local Event.
    • FortiWeb: Application Attack Prevention, Event, and Traffic.
    • FortiCache: Application, Intrusion Prevention, Content , Data Leak Prevention, Email Filter, Event, Vulnerability Scan, Traffic, Antivirus, VoIP, and Web Filter.
    • FortiClient: System Event, Security Event, Traffic.
    • Syslog: Syslog.
    • FortiManager: Applicationand Event.
    • FortiSandbox: Event, Vulnerability Scan, and Antivirus.
    • FortiDDoS: Intrusion Prevention and Event.
    • FortiAuthenticator: Event.
    • FortiProxy: Application, Intrusion Prevention, Content , Data Leak Prevention, DNS, Email Filter, Event, File Filter, Vulnerability Scan, Protocol, SSH, SSL, Traffic, Antivirus, VoIP, and Web Filter.
    • FortiNAC: Asset and Event.
    • FortiFirewall: DNS, Event, File Filter, GTP, SSH, SSL, and Traffic.
    • FortiDeceptor: Event.
    • FortiSOAR: Event
    • FortiAI: Attack and Event.
    • Fabric: Normalized.

    Query

    Enter the SQL query used for the dataset. An easy way to build a custom query is to copy and modify a predefined dataset's query.

    Variables

    Click the Add button to add variable, expression, and description information.

    If added, the expression for the variable will be used when configuring filters for reports that use this dataset. For example, if Variable = User (user) and Expression = coalesce(nullifna(`user`), ipstr(`srcip`)), then the expression will be used when User (user) is selected as the Log Field in a report's filter. See Filtering report output.

    Test query with specified devices and time period

    Time Period

    Use the dropdown list to select a time period. When selecting Custom, enter the start date and time, and the end date and time.

    Devices

    Select All Devices or Specify to select specific devices to run the SQL query against. Click the Select Device button to add multiple devices to the query.

    Test

    Click to test the SQL query before saving the dataset configuration.

  4. Click Test.

    The query results are displayed. If the query is not successful, an error message appears in the Test Result pane.

  5. Click OK.