Time Series Database:CLI TSDB for InfluxDB®

Deskripsi parameter

• -ssl: terhubung ke server InfluxDB melalui HTTPS.

• -username: username akun yang telah Anda buat.

• -password: password akun tersebut.

• -host: titik akhir instans. Ganti ts-xxxxxx dengan ID instans Anda.

• -port: port jaringan. Gunakan 8086 untuk koneksi VPC dan 3242 untuk koneksi Internet.

Anda kini dapat memasukkan kueri InfluxQL dan beberapa perintah CLI langsung di terminal. Untuk memasukkan kueri Flux, atur opsi -type menjadi flux. Anda dapat menjalankan help kapan saja untuk menampilkan daftar perintah yang tersedia. Untuk menghentikan kueri InfluxQL yang berjalan lama, tekan Ctrl+C.

Variabel lingkungan

Variabel lingkungan berikut dapat digunakan untuk mengonfigurasi pengaturan client influx. Anda dapat menentukannya dalam huruf kecil atau kapital. Huruf kapital memiliki prioritas lebih tinggi.

HTTP_PROXY

Menentukan server proxy yang digunakan oleh HTTP.

Format nilai: [protocol://][:port]

HTTP_PROXY=http://localhost:1234

HTTPS_PROXY

Menentukan server proxy yang digunakan oleh HTTPS. Jika kedua variabel HTTP_PROXY dan HTTPS_PROXY diatur, HTTPS_PROXY memiliki prioritas lebih tinggi.

Format nilai: [protocol://][:port]

HTTPS_PROXY=https://localhost:1443

NO_PROXY

Daftar nama host yang tidak melewati proxy apa pun. Jika variabel ini hanya diatur ke tanda bintang (*), maka semua host akan cocok.

Format nilai: pisahkan beberapa host dengan koma.

NO_PROXY=123.45.67.89,123.45.67.90

Opsi influx

Anda dapat memberikan opsi ke influx saat memulai influx. Jalankan $ influx --help untuk menampilkan daftar opsi yang tersedia. Daftar berikut menjelaskan secara singkat setiap opsi. Opsi -execute, -format, dan -import dijelaskan secara lebih rinci di bagian ini.

-compressed

Aktifkan opsi ini jika file impor dikompresi. -compressed harus digunakan bersamaan dengan -import.

Mengatur tingkat konsistensi penulisan.

-database 'database name'

Database yang akan dihubungi oleh influx.

-execute '<command>'

Menjalankan perintah InfluxQL lalu keluar.

-format 'json|csv|column'

Menentukan format tanggapan server.

-host '<hostname>'

Host yang akan dihubungi oleh influx.

-import

Mengimpor data baru dari file, atau mengimpor database yang sebelumnya diekspor ke file.

-password '<password>'

Password yang digunakan oleh influx untuk terhubung ke server. Jika Anda mengosongkan opsi ini (-password ''), influx akan meminta Anda memasukkan password. Anda juga dapat menggunakan variabel lingkungan INFLUX_PASSWORD untuk mengatur password CLI.

-path

Jalur menuju file impor. -path harus digunakan bersamaan dengan -import.

-port 'port #'

Port yang akan dihubungi oleh influx. Secara default, TSDB for InfluxDB® berjalan pada port 3242.

-pps

Jumlah titik data per detik yang diizinkan selama impor. Secara default, pps diatur ke 0 dan influx tidak membatasi laju impor. -pps harus digunakan bersamaan dengan -import.

-precision 'rfc3339|h|m|s|ms|u|ns'

Menentukan format dan presisi timestamp untuk kueri dan penulisan: rfc3339 (YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ), h (jam), m (menit), s (detik), ms (milidetik), u (mikrodetik), atau ns (nanodetik). Presisi default adalah nanodetik.

-pretty

Menampilkan output JSON dalam format yang mudah dibaca.

-ssl

Menggunakan HTTPS untuk permintaan.

-type

Menentukan shell interaktif yang digunakan. Nilai default adalah influxql. Untuk menggunakan shell REPL Flux, atur -type menjadi flux.

-username 'username'

Username yang digunakan oleh influx untuk terhubung ke server. Anda juga dapat menggunakan variabel lingkungan INFLUX_USERNAME untuk mengatur username CLI.

-version

Menampilkan versi TSDB for InfluxDB® lalu keluar.

Gunakan -execute untuk menjalankan perintah InfluxQL lalu keluar

Jalankan kueri yang tidak memerlukan database:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -execute 'SHOW DATABASES'
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates

Jalankan kueri yang memerlukan database dan ubah presisi timestamp:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -execute 'SELECT * FROM "h2o_feet" LIMIT 3' -database="NOAA_water_database" -precision=rfc3339
name: h2o_feet
--------------
time                     level description     location      water_level
2015-08-18T00:00:00Z     below 3 feet          santa_monica  2.064
2015-08-18T00:00:00Z     between 6 and 9 feet  coyote_creek  8.12
2015-08-18T00:06:00Z     between 6 and 9 feet  coyote_creek  8.005

Gunakan -format untuk menentukan format tanggapan server

Format default adalah column:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=column
[...]
> SHOW DATABASES
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates

Ubah format menjadi csv:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=csv
[...]
> SHOW DATABASES
name,name
databases,NOAA_water_database
databases,_internal
databases,telegraf
databases,pirates

Ubah format menjadi json:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=json
[...]
> SHOW DATABASES
{"results":[{"series":[{"name":"databases","columns":["name"],"values":[["NOAA_water_database"],["_internal"],["telegraf"],["pirates"]]}]}]}

Ubah format menjadi JSON dan aktifkan output pretty-printed:

$ influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -format=json -pretty
[...]
> SHOW DATABASES
{
    "results": [  
        {
            "series": [
                {
                    "name": "databases",
                    "columns": [
                        "name"
                    ],
                    "values": [
                        [
                            "NOAA_water_database"                       
                        ],
                        [
                            "_internal"
                        ],
                        [
                            "telegraf"
                        ],
                        [
                            "pirates"
                        ]
                    ]
                }
            ]
        }
    ]
}

Gunakan -import untuk mengimpor data dari file

File impor terdiri dari dua bagian:

Contoh:

Asumsikan database bernama pirates dan kebijakan retensi bernama oneday telah dibuat.

File (datarrr.txt):

# DML
# CONTEXT-DATABASE: pirates
# CONTEXT-RETENTION-POLICY: oneday
treasures,captain_id=dread_pirate_roberts value=801 1439856000
treasures,captain_id=flint value=29 1439856000
treasures,captain_id=sparrow value=38 1439856000
treasures,captain_id=tetra value=47 1439856000
treasures,captain_id=crunch value=109 1439858880

Perintah:

$influx -ssl -username <Username> -password <Password> -host <Endpoint> -port 3242 -import -path=datarrr.txt -precision=s

Hasil:

2015/12/22 12:25:06 Processed 0 commands
2015/12/22 12:25:06 Processed 5 inserts
2015/12/22 12:25:06 Failed 0 inserts

Catatan

Perhatikan hal-hal berikut mengenai -import:

• Gunakan

  -pps

  untuk mengatur jumlah titik data per detik yang diizinkan saat menulis titik data ke database. Secara default, PPS diatur ke 0 dan

  influx

  tidak membatasi laju impor.

• Anda dapat mengimpor file .gz dengan cukup menambahkannya.

  -compressed

  ke perintah.

• Sediakan timestamp untuk titik data dalam file. TSDB for InfluxDB® akan memberikan timestamp yang sama untuk titik data yang tidak memiliki timestamp, yang dapat menyebabkan penimpaan data yang tidak diinginkan.

• Jika file data Anda berisi lebih dari 5.000 titik data, Anda mungkin perlu membagi file tersebut menjadi beberapa file agar data dapat ditulis ke TSDB for InfluxDB® dalam batch. Tulis data ke TSDB for InfluxDB® dalam batch berisi 5.000 atau 10.000 titik data. Batch yang lebih kecil menghasilkan lebih banyak permintaan HTTP, sehingga menghambat performa optimal. Secara default, permintaan HTTP akan timeout setelah lima detik. TSDB for InfluxDB® tetap mencoba menulis titik data setelah timeout, tetapi tidak ada jaminan bahwa titik data tersebut berhasil ditulis.

Perintah influx