Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Overview
You can use the Threat Analytics Manager to import Logstash records into Data Sources.
Using the wizard, it is easy to specify header rows, field names, as well as quote and separator characters.
Importing the CSV File
To import the CSV record
- From the Treat Analytics Dashboard, click on Data Sources (top right).
- Under "What kind of source would you like to create?" specify "CSV Record Logstash Import Source."
- Click on Next.
- Configure the fields as described in the table below.
| Field | Description | Note | |||
|---|---|---|---|---|---|
| File Path | Local file path where the CSV file can be located. | support for urls? | |||
| Date | Specific date that you would like to associate with the uploaded CSV file | What is the benefit of this, especially for files where each record has different date/time? | |||
| Time | Specific time that you would like to associate with the imported CSV fileS3 Location | URL for the Amazon s3 bucket. eg. test.ikanow.com | |||
| S3 Username | Username for the Amazon s3 bucket. | ||||
| S3 Password | Password for the Amazon s3 bucket. | ||||
| Quote Character | Default: "These should not require manual input, and should take defaults if user specifies nothing (currently throws an error). Default values should be viewable on GUI | Standard characters have been selected for the quote and separators. You may chose from the list of other common options or add your own based off your data. | |||
| Separator | Default: , | Escape | Default: \ | Shouldn't escape also be on the GUI? Standard characters have been selected for the quote and separators. You may chose from the list of other common options or add your own based off your data. | |
| Column Headers | Manually Used to manually specify each column header Shouldn't have to do this. Eg. If each header field starts with '#' they should be able to only specify this. Or leave blank for platform to do it automatically.for separated values files. (eg. csv) |
Advanced Options
The following fields are also available for more advanced CSV Logstash import settings.
| Field | Description | Note | ||
|---|---|---|---|---|
| Geo IP | Input the "src_ip" (source IP address) that you want associated to this record. It will be used to geocode the CSV field to latitude and longitude information. | Type | ||
| Date Column | Column name that holds the Date/Time. | Not sure what this is referring to. | ||
| Date/Time Mask | Date/time format: MM/dd/yyyy HH:mm:ss The date filter is used for parsing dates from fields, and then using that date or timestamp as the logstash timestamp for the event. For example, syslog events usually have timestamps like this: You would use the date format “MMM dd HH:mm:ss” to parse this. | |||
| Type | Default value: SNORT Optional string that describes the type of file for the logstash configuration. eg. "apache", "syslog" Mainly used for filter activation.
|
Configuring and Testing
Once you have made the input settings, you will need to perform additional configuration and testing.
To configure and test
- Provide a name for the source.
- Select the previously created Data Group. todo link to data group.
- Specify the frequency at which the source should be harvested (eg. Once per day)
- Click on Test.
About Testing
If the source has been configured properly testing with return test results, and you will be able to move forward with Publishing the new source. Otherwise, a failure message is generated which can be used for troubleshooting (currently it only says FAIL). You can always Save your source and come back to fix any testing errors later.
Saving or Publishing
Saving
To save the source after testing
- Click on Save.
The source is saved and you are re-directed to the Source Manager.
Publishing
To publish the source after testing
- Click on Publish.
The source is published and you are re-directed to the list Source Manager.
| Panel |
|---|
In this section:
|
| Panel |
|---|
Related Documentation:
|
| Panel |
|---|
|