Graylog Connector
Intro
Graylog is an integrated log capture and analysis solution for operational intelligence. Use Domo's Graylog connector to retrieve Graylog data based on a search query. To learn more about the Graylog API, visit their page (http://docs.graylog.org/en/2.4/pages.../rest_api.html).
You connect to your Graylog account in the Data Center. This topic discusses the fields and menus that are specific to the Graylog connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your Graylog account and create a DataSet, you must have the following:
-
The username and password for the Graylog account you want to pull data from
-
The host URL you want to connect to (e.g. https://server1:12900)
Connecting to Your Graylog Account
This section enumerates the options in the Credentials and Details panes in the Graylog Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your Graylog account. The following table describes what is needed for each field:
Field |
Description |
---|---|
Username |
Enter the password for the Graylog account you want to pull data from. |
Password |
Enter the password for the Graylog account you want to pull data from. |
Host URL |
Enter the host URL you want to connect to. |
Once you have entered valid Graylog credentials, you can use the same account any time you go to create a new Graylog DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.
Menu |
Description |
||||||
---|---|---|---|---|---|---|---|
Report |
Select the Graylog report you want to run. The following reports are available:
|
||||||
From Date |
Select the first date in the desired date range for your "Search Absolute" report. |
||||||
To Date |
Select the last date in the desired date range for your "Search Absolute" report. |
||||||
Range Keyword |
Enter a keyword or keywords indicating the desired timeframe for your "Search Keyword" report, such as yesterday or 2 weeks ago to Wednesday. |
||||||
Relative Range to Search |
Enter the number of seconds back for which you want to retrieve data for your "Search Relative" report. For example, if you entered 90, each time the report was updated it would pull in data for the last 90 seconds. |
||||||
Fields to Return (optional) |
Enter the names of the columns you want to import from Graylog into Domo. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.