Skip to content

Latest commit

 

History

History
69 lines (57 loc) · 8.06 KB

README.md

File metadata and controls

69 lines (57 loc) · 8.06 KB

Influxer

A C# console application to parse log files (currently only Windows Perfmon format) and push data to Influx for later visualization. It uses InfluxDB.Client.Net to interact with Influx.

InfluxDB is a very nice time series database, and is supported by many data visualizers (mainly grafana). But if you have other tools which are producing the data in csv format (mainly PerfMon in windows, or enterprise reporting tools) which are not designed for Influx era, you will have to develop own tools to pull from one tool and to push to other.

Meet Influxer, a small C# console application, which will take any text files with time series and upload it to any Influx instance. It has special handling for Microsoft Windows Perfmon file format. It can be configured (via command line or by configuration files) to handle any type of text files.

Steps to generate configuration file
  1. Find out the time format for the input file
  2. Run the Influxer with -timeformat -input /export /autolayout
  3. Once you see the configuration output on screen, rerun with output redirect (> somefile) to save the configuration

Build Status

Build status

 	Supported command line arguments
--help /? or /help  shows this help text


/export to print possible config section, pipe it to a file to edit and reuse the config

-config <configuration file path> to load the config file.

Any configuration entries can be overridden by command line switches shown below

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Required flags
-format <format>                                        Input file format. Supported: Perfmon, Generic                                                      -input <file name>                                  Input file name                                                                                     ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
InfluxDB related flags
-dbName <name>                                          Influx database Name, will be created if not present                                                     Default:InfluxerDB
-influx <Url>                                           Influx DB Url including port                                                                             Default:http://localhost:8086
-table <table name>                                     Measurement name in InfluxDB                                                                             Default:InfluxerData
-pass <password>                                        Password for InfluxDB
-batch <number of points>                               No of points to send to InfluxDB in one request                                                          Default:128
-retentionDuration <number of minutes>                  No of minutes that the data will be retained by InfluxDB, if noneof the plcies match, a new one will be created
-retention <policy name>                                Name of the InfluxDB retention policy where the taget measurements will be created. RetentionDuration takes precedence over this
-uname <username>                                       User name for InfluxDB
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Perfmon file format related flags
-columns <column list>                                  Comma seperated list of Columns to import                                                                Default:
-splitter <regex>                                       RegEx used for splitting rows into columns                                                               Default:,(?=(?:[^"]*"[^"]*")*[^"]*$)
-tags <tag=value,tag2=value>                            Tags to be passed with every value,Comma seperated key value pairs                                       Default:
-filter <filter>                                        Filter input data file, Supported:Measurement (import preexisting measurements), Field (import preexisting fields), Columns (import specified columns)   Default:
-MultiMeasurements                                      Push each Performance counter into their own Measurements                                                Default:
-Precision <precision>                                  Supported:Hours<1>,Minutes<2>,Seconds<3>,MilliSeconds<4>,MicroSeconds<5>,NanoSeconds<6>                  Default:Seconds
-TimeFormat <format>                                    Time format used in input files                                                                          Default:MM/dd/yyyy HH:mm:ss.fff
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Generic delimited file format related flags
-ignore <char>                                          Lines starting with <char> are considered as comments, and ignored
-noheader                                               Input file does not have column headers, configuration file should provide a column header mapping       Default:
-header <Row No>                                        Indicates which row to use to get column headers                                                         Default:1
-ignoreerrors                                           Ignore too many errors due to invalid data or config file                                                Default:
-skip <Row No>                                          Indicates how may roaws should be skipped after header row to get data rows                              Default:
-timetype <type>                                        Type of Time format used in input files, String, Epoch or Binary                                         Default:String
-utcoffset <No of Minutes>                              Offset in minutes to UTC, each line in input will be adjusted to arrive time in UTC                      Default:
-validate <No of Rows>                                  Validates n rows for consistent column data types                                                        Default:10
-columns <column list>                                  Comma seperated list of Columns to import                                                                Default:
-splitter <regex>                                       RegEx used for splitting rows into columns                                                               Default:,(?=(?:[^"]*"[^"]*")*[^"]*$)
-tags <tag=value,tag2=value>                            Tags to be passed with every value,Comma seperated key value pairs                                       Default:
-filter <filter>                                        Filter input data file, Supported:Measurement (import preexisting measurements), Field (import preexisting fields), Columns (import specified columns)   Default:
-MultiMeasurements                                      Push each Performance counter into their own Measurements                                                Default:
-Precision <precision>                                  Supported:Hours<1>,Minutes<2>,Seconds<3>,MilliSeconds<4>,MicroSeconds<5>,NanoSeconds<6>                  Default:Seconds
-TimeFormat <format>                                    Time format used in input files                                                                          Default:MM/dd/yyyy HH:mm:ss.fff