地址:https://docs.influxdata.com/chronograf/v1.6/introduction/getting-started/
開始使用Chronograf
在本頁面
入門概述
Chronograf是InfluxData的TICK堆棧的用戶界面組件。它使您的基礎架構的監控和警報易於設置和維護。
接下來的部分將使用盡可能少的配置和代碼啟動並運行Chronograf。在本文檔的最后,您將下載,安裝和配置TICK堆棧的所有四個軟件包(Telegraf,InfluxDB,Chronograf和Kapacitor),您將全部監控您的基礎架構。
要求
本指南介紹如何在Ubuntu 16.04安裝上進行設置,適用於大多數Linux版本。在大量操作系統和硬件架構上支持Chronograf和TICK堆棧的其他組件。查看下載頁面,獲取您選擇的二進制文件的鏈接。
有關安裝要求的完整列表,請參閱“ 安裝”頁面。
InfluxDB安裝程序
InfluxDB是時間序列數據庫,用作TICK堆棧的數據存儲組件。
1.下載並安裝InfluxDB
wget https://dl.influxdata.com/influxdb/releases/influxdb_1.4.0_amd64.deb
sudo dpkg -i influxdb_1.4.0_amd64.deb
2.啟動InfluxDB
出於本指南的目的,無需編輯InfluxDB的默認配置。只需啟動InfluxDB:
sudo systemctl start influxdb
3.驗證InfluxDB是否正在運行
使用SHOW DATABASES
curl命令驗證InfluxDB是否已啟動並正在運行:
curl "http://localhost:8086/query?q=show+databases"
如果InfluxDB正在運行,您應該看到一個包含_internal
數據庫的對象:
{"results":[{"statement_id":0,"series":[{"name":"databases","columns":["name"],"values":[["_internal"]]}]}]}
到現在為止還挺好!您已准備好繼續下一部分。請注意,您無需在InfluxDB實例上創建自己的數據庫; TICK堆棧的其他組件將為您處理。
Kapacitor設置
Kapacitor是TICK堆棧的數據處理平台。Kapacitor負責在Chronograf中創建和發送警報。
1.下載並安裝Kapacitor
wget https://dl.influxdata.com/kapacitor/releases/kapacitor_1.4.0_amd64.deb
sudo dpkg -i kapacitor_1.4.0_amd64.deb
2.啟動Kapacitor
sudo systemctl start kapacitor
3.驗證Kapacitor是否正在運行
檢查task
Kapacitor列表:
kapacitor list tasks
如果Kapacitor啟動並運行,您應該看到一個空的任務列表:
ID Type Status Executing Databases and Retention Policies
如果出現問題,您將看到錯誤消息:
Get http://localhost:9092/kapacitor/v1/tasks?dot-view=attributes&fields=type&fields=status&fields=executing&fields=dbrps&limit=100&offset=0&pattern=&replay-id=&script-format=formatted: dial tcp [::1]:9092: getsockopt: connection refused
Telegraf設置
Telegraf是TICK堆棧中的度量收集代理。出於本指南的目的,我們設置Telegraf以收集計算機上的系統統計數據,並將這些指標寫入現有的InfluxDB實例。
在生產環境中,Telegraf將安裝在您的服務器上,並將輸出指向另一台機器上的InfluxDB實例。最終,您將為要監視的每個應用程序配置Telegraf輸入插件。
1.下載並安裝Telegraf
wget https://dl.influxdata.com/telegraf/releases/telegraf_1.4.3-1_amd64.deb
sudo dpkg -i telegraf_1.4.3-1_amd64.deb
2.啟動Telegraf
sudo systemctl start telegraf
3.確認Telegraf正在運行
第2步應創建一個配置文件,其中系統統計信息作為輸入插件,InfluxDB作為輸出插件。
仔細檢查配置文件,/etc/telegraf/telegraf.conf
查看相關的輸入和輸出設置。該OUTPUT PLUGINS
部分應具有以下InfluxDB輸出設置:
[[outputs.influxdb]]
## The full HTTP or UDP endpoint URL for your InfluxDB instance.
## Multiple urls can be specified as part of the same cluster,
## this means that only ONE of the urls will be written to each interval.
# urls = ["udp://localhost:8089"] # UDP endpoint example
urls = ["http://localhost:8086"] # required
## The target database for metrics (telegraf will create it if not exists).
database = "telegraf" # required
## Retention policy to write to. Empty string writes to the default rp.
retention_policy = ""
## Write consistency (clusters only), can be: "any", "one", "quorum", "all"
write_consistency = "any"
## Write timeout (for the InfluxDB client), formatted as a string.
## If not provided, will default to 5s. 0s means no timeout (not recommended).
timeout = "5s"
# username = "telegraf"
# password = "metricsmetricsmetricsmetrics"
## Set the user agent for HTTP POSTs (can be useful for log differentiation)
# user_agent = "telegraf"
## Set UDP payload size, defaults to InfluxDB UDP Client default (512 bytes)
# udp_payload = 512
接下來,該INPUT PLUGINS
部分應具有系統統計信息輸入的以下設置:
# Read metrics about cpu usage
[[inputs.cpu]]
## Whether to report per-cpu stats or not
percpu = true
## Whether to report total system cpu stats or not
totalcpu = true
## If true, collect raw CPU time metrics.
collect_cpu_time = false
# Read metrics about disk usage by mount point
[[inputs.disk]]
## By default, telegraf gather stats for all mountpoints.
## Setting mountpoints will restrict the stats to the specified mountpoints.
# mount_points = ["/"]
## Ignore some mountpoints by filesystem type. For example (dev)tmpfs (usually
## present on /run, /var/run, /dev/shm or /dev).
ignore_fs = ["tmpfs", "devtmpfs"]
# Read metrics about disk IO by device
[[inputs.diskio]]
## By default, telegraf will gather stats for all devices including
## disk partitions.
## Setting devices will restrict the stats to the specified devices.
# devices = ["sda", "sdb"]
## Uncomment the following line if you need disk serial numbers.
# skip_serial_number = false
# Get kernel statistics from /proc/stat
[[inputs.kernel]]
# no configuration
# Read metrics about memory usage
[[inputs.mem]]
# no configuration
# Get the number of processes and group them by status
[[inputs.processes]]
# no configuration
# Read metrics about swap memory usage
[[inputs.swap]]
# no configuration
# Read metrics about system load & uptime
[[inputs.system]]
# no configuration
Windows主機上的系統統計信息
對於Windows主機, 必須啟用
win_perf_counters
Telegraf輸入插件並將其配置為正確地向InfluxDB報告主機統計信息。
要測試系統統計信息是否正在寫入InfluxDB,請運行以下curl
命令:
curl "http://localhost:8086/query?q=select+*+from+telegraf..cpu"
如果Telegraf設置正確,您應該會看到很多JSON數據; 如果輸出為空則出現問題。
Chronograf設置
現在我們正在使用Telegraf收集數據並使用InfluxDB存儲數據,現在是時候安裝Chronograf來開始查看和監控數據了。
1.下載並安裝Chronograf
wget https://dl.influxdata.com/chronograf/releases/chronograf_1.4.0.0_amd64.deb
sudo dpkg -i chronograf_1.4.0.0_amd64.deb
2.啟動Chronograf
sudo systemctl start chronograf
3.連接到Chronograf
假設一切正常,我們應該能夠連接並配置Chronograf。將Web瀏覽器指向http://localhost:8888
(localhost
如果您沒有運行,則替換為服務器的IP localhost
)。
你應該看到一個歡迎頁面:
接下來的步驟將Chronograf連接到您的InfluxDB實例。對於Connection String
,輸入運行InfluxDB的機器的主機名或IP,並確保包含InfluxDB的默認端口:8086
。接下來,命名連接字符串; 這可以是你想要的任何東西。無需編輯最后三個輸入; 禁用授權在InfluxDB的默認配置,Username
並且Password
可以保持空白,Telegraf的默認數據庫名稱為telegraf
。
點擊Connect New Source
進入該HOST LIST
頁面:
您應該在頁面上看到計算機的主機名以及有關其CPU使用率和負載的信息。假設您已配置Telegraf的系統統計信息輸入插件,system
則應顯示在Apps
列中。繼續並單擊主機名以查看有關主機的一系列系統級圖表:
4.將Chronograf連接到Kapacitor
安裝過程的最后一步是將Chronograf連接到Kapacitor。導航到配置頁面(側邊欄的最后一個項目),然后單擊Add Config
在Active Kapacitor
列。
對於Kapacitor URL
,輸入運行Kapacitor的計算機的主機名或IP,並確保包含Kapacitor的默認端口:9092
。接下來,命名連接字符串; 這可以是你想要的任何東西。由於在Kapacitor的默認配置中禁用了授權,因此無需為Username
和Password
輸入輸入任何信息。最后,點擊Connect
。
當Kapacitor成功連接時,Chronograf會自動打開該Configure Alert Endpoints
部分。Kapacitor支持多個警報端點/事件處理程序。有關詳細信息,請參閱“ 配置Chronograf警報端點”指南。
而已!您已成功下載,安裝和配置TICK堆棧的每個組件。接下來,查看我們的指南,熟悉Chronograf,看看你可以用它做的一切!