Repository files navigation

中文版

Very powerful server agent for collecting & sending logs & metrics with an easy-to-use web console.

• File: read data in file, including csv file，kafka-rest log，nginx log.
• Elasticsearch: read data in ElasticSearch.
• MongoDB: read data in MongoDB.
• MySQL: read data in MySQL.
• MicroSoft SQL Server: read data in Microsoft SQL Server.
• Postgre SQL: read data in PostgreSQL.
• Kafka: read data in Kafka.
• Redis: read data in Redis.
• Socket: read data via tcp\udp\unixsocket protocol.
• Http: reveive data in post request as http server.
• Script: support script and read data from the result.
• Snmp: auto read data from Snmp service.

logkit-community support multiple sources and can send kinds of data to Pandora, every data source relevant to a logic runner,a runner's workaround as follows:

Weclome to contribute to logkit:

• fix orreport bug
• pull issue improvewiki doc
• review code orcreate issues
• contribute code (contribute kinds of modules includingreader、parser、sender andtransformer）

lastest stable：Go toDownload page

History：Go toReleases

Trial：construct lastest logkit trial version every 5:00am (only for Linux 64 and Docker), you can download it (note: not include update of frontend).

• Linux 64 download

• Docker image nightly:docker pull wonderflow/logkit:nightly

• Linux

export LOGKIT_VERSION=<version number>wget https://pandora-dl.qiniu.com/logkit_${LOGKIT_VERSION}.tar.gz&& tar xvf logkit_${LOGKIT_VERSION}.tar.gz&& rm logkit_${LOGKIT_VERSION}.tar.gz&&cd _package_linux64/

• MacOS

export LOGKIT_VERSION=<version number>wget https://pandora-dl.qiniu.com/logkit_mac_${LOGKIT_VERSION}.tar.gz&& tar xvf logkit_mac_${LOGKIT_VERSION}.tar.gz&& rm logkit_mac_${LOGKIT_VERSION}.tar.gz&&cd _package_mac/

• Windows

please downloadhttps://pandora-dl.qiniu.com/logkit_windows_<LOGKIT_VERSION>.zip 并解压缩，go to directory

logkit.conf is logkit-community tool's configuration，mainly for specifing running resource and paths of runners.

Openlogkit.conf, for example：

{"max_procs":8,"debug_level":1,"clean_self_log":true,"bind_host":"localhost:3000","static_root_path":"./public","confs_path": ["confs*"]}

For simply use, you can only focus on three options:

1. bind_host port of logkit we。
2. static_root_path statistic resource path of logkit page,recommand to use absolute path note：old version moved to "public-old" directory。
3. confs_path including add conf in web, logkit also support monitor directory to add runners. (if you only need to add logkit runner in web, you can ignore this option)

./logkit -f logkit.conf

the web url is the value ofbind_host configured in step 2

refer to README file：logkitweb/README.md

go build -o logkit logkit.go./logkit -f logkit.conf

docker pull wonderflow/logkit:<version>docker run -d -p 3000:3000 -v /local/logkit/dataconf:/app/confs -v /local/log/path:/logs/path logkit:<version>

get configs deploying in Kubernetes

curl -L -O https://raw.githubusercontent.com/qiniu/logkit/master/deploy/logkit_on_k8s.yaml

enjoy it！