pt-heartbeatp - Online di Cloud

PROGRAM:

NAMA

pt-heartbeat - Pantau penundaan replikasi MySQL.

RINGKASAN

Penggunaan: pt-detak jantung [OPSI] [DSN] --update|--monitor|--check|--stop

pt-heartbeat mengukur jeda replikasi di server MySQL atau PostgreSQL. Anda dapat menggunakannya untuk
memperbarui master atau memantau replika. Jika memungkinkan, opsi koneksi MySQL dibaca dari
file .my.cnf Anda.

Mulai proses daemonisasi untuk memperbarui tabel test.heartbeat pada master:

pt-detak jantung -D test --update -h master-server --daemonize

Pantau jeda replikasi pada slave:

pt-detak jantung -D test --monitor -h slave-server

pt-detak jantung -D test --monitor -h slave-server --dbi-driver Pg

Periksa lag budak sekali dan keluar (menggunakan DSN opsional untuk menentukan host budak):

pt-detak jantung -D test --periksa h=slave-server

RISIKO

Percona Toolkit sudah matang, terbukti di dunia nyata, dan teruji dengan baik, tetapi semua basis data
alat dapat menimbulkan risiko bagi sistem dan server database. Sebelum menggunakan alat ini,
mohon untuk:

· Baca dokumentasi alat ini

· Tinjau "BUGS" alat yang dikenal

· Uji alat di server non-produksi

· Cadangkan server produksi Anda dan verifikasi cadangannya

DESKRIPSI

pt-heartbeat adalah sistem pemantauan penundaan replikasi MySQL dan PostgreSQL dua bagian yang
mengukur penundaan dengan melihat data aktual yang direplikasi. Ini menghindari ketergantungan pada
mekanisme replikasi itu sendiri, yang tidak dapat diandalkan. (Misalnya, "TAMPILKAN STATUS BUDAK" di
MySQL).

Bagian pertama adalah contoh "--update" dari pt-detak jantung yang terhubung ke master dan
memperbarui stempel waktu ("catatan detak jantung") setiap "--interval" detik. Sejak detak jantung
tabel mungkin berisi catatan dari beberapa master (lihat "HIERARKI MULTI-BUDAK"),
ID server (@@server_id) digunakan untuk mengidentifikasi record.

Bagian kedua adalah contoh "--monitor" atau "--check" dari pt-heartbeat yang terhubung ke
slave, memeriksa rekaman detak jantung yang direplikasi dari master langsungnya atau yang ditentukan
"--master-server-id", dan menghitung perbedaan dari waktu sistem saat ini. Jika
replikasi antara budak dan master tertunda atau rusak, perbedaan yang dihitung
akan lebih besar dari nol dan berpotensi meningkat jika "--monitor" ditentukan.

Anda harus membuat tabel detak jantung secara manual pada master atau menggunakan "--create-table".
Lihat "--create-table" untuk struktur tabel detak jantung yang tepat. Penyimpanan "MEMORY"
engine disarankan, tetapi tentu saja tidak diperlukan, untuk MySQL.

Tabel detak jantung harus berisi baris detak jantung. Secara default, baris detak jantung dimasukkan
jika tidak ada. Fitur ini dapat dinonaktifkan dengan "--[no]insert-heartbeat-row"
opsi jika pengguna database tidak memiliki hak INSERT.

pt-detak jantung hanya bergantung pada rekaman detak jantung yang direplikasi ke budak, jadi itu
bekerja terlepas dari mekanisme replikasi (replikasi bawaan, sistem seperti
Tungsten Lanjutan, dll). Ia bekerja pada kedalaman apa pun dalam hierarki replikasi; untuk
misalnya, ia akan dengan andal melaporkan seberapa jauh seorang budak tertinggal dari tuan tuannya. Dan
jika replikasi dihentikan, itu akan terus bekerja dan melaporkan (secara akurat!) bahwa
budak jatuh lebih jauh dan lebih jauh di belakang tuannya.

pt-heartbeat memiliki resolusi maksimum 0.01 detik. Jam pada master dan slave
server harus disinkronkan dengan erat melalui NTP. Secara default, pemeriksaan "--update" terjadi pada
tepi detik (misalnya 00:01) dan pemeriksaan "--monitor" terjadi di antara detik
(misalnya 00:01.5). Selama jam server disinkronkan dan direplikasi
peristiwa menyebar dalam waktu kurang dari setengah detik, pt-detak jantung akan melaporkan nol detik
keterlambatan.

pt-heartbeat akan mencoba menyambung kembali jika koneksi mengalami kesalahan, tetapi tidak akan mencoba lagi jika
itu tidak bisa mendapatkan koneksi saat pertama kali dimulai.

Opsi "--dbi-driver" memungkinkan Anda menggunakan pt-heartbeat untuk memantau PostgreSQL juga. Dia
dilaporkan bekerja dengan baik dengan replikasi Slony-1.

MULTI-BUDAK HIRARKI

Jika hierarki replikasi memiliki banyak budak yang merupakan tuan dari budak lain, seperti
Instance "master -> slave1 -> slave2", "--update" dapat dijalankan pada slave serta
menguasai. Tabel detak jantung default (lihat "--create-table") dikunci pada "server_id"
kolom, sehingga setiap server akan memperbarui baris di mana "server_id=@@server_id".

Untuk "--monitor" dan "--check", jika "--master-server-id" tidak ditentukan, alat akan mencoba
temukan dan gunakan master langsung budak itu. Jika ini gagal, atau jika Anda ingin monitor lag
dari master lain, maka Anda dapat menentukan "--master-server-id" yang akan digunakan.

Misalnya, jika hierarki replikasi adalah "master -> slave1 -> slave2" dengan
ID server 1, 2 dan 3 yang sesuai, Anda dapat:

pt-detak jantung --daemonize -D test --update -h master
pt-detak jantung --daemonize -D test --update -h slave1

Kemudian periksa (atau pantau) penundaan replikasi dari master ke slave2:

pt-detak jantung -D tes --master-server-id 1 --periksa slave2

Atau periksa penundaan replikasi dari slave1 ke slave2:

pt-detak jantung -D tes --master-server-id 2 --periksa slave2

Menghentikan instance "--update" one slave1 tidak akan memengaruhi instance pada master.

MASTER DAN BUDAK STATUS

Tabel detak jantung default (lihat "--buat-tabel") memiliki kolom untuk menyimpan informasi dari
"TAMPILKAN STATUS MASTER" dan "TUNJUKKAN STATUS BUDAK". Kolom ini opsional. Jika ada
saat ini, informasi terkait mereka akan disimpan.

percona XtraDB Kelompok

Meskipun pt-detak jantung harus bekerja dengan semua versi yang didukung dari Percona XtraDB Cluster
(PXC), sebaiknya gunakan 5.5.28-23.7 dan yang lebih baru.

Jika Anda menyiapkan instance detak jantung di antara node cluster, ingatlah bahwa, karena
kecepatan cluster ditentukan oleh node paling lambat, pt-detak jantung tidak akan melaporkan
seberapa cepat cluster itu sendiri, tetapi hanya seberapa cepat peristiwa mereplikasi dari satu node ke
lain.

Anda harus menentukan "--master-server-id" untuk instance "--monitor" dan "--check".

PILIHAN

Tentukan setidaknya satu dari "--stop", "--update", "--monitor", atau "--check".

"--update", "--monitor", dan "--check" saling eksklusif.

"--daemonize" dan "--check" saling eksklusif.

Alat ini menerima argumen baris perintah tambahan. Lihat "SINOPSIS" dan penggunaan
informasi untuk rincian.

--ask-lulus
Meminta kata sandi saat menghubungkan ke MySQL.

--rangkaian karakter
bentuk pendek: -A; jenis: string

Kumpulan karakter default. Jika nilainya utf8, setel binmode Perl di STDOUT ke utf8,
meneruskan opsi mysql_enable_utf8 ke DBD::mysql, dan menjalankan SET NAMES UTF8 setelahnya
menghubungkan ke MySQL. Nilai lain apa pun menetapkan binmode pada STDOUT tanpa lapisan utf8,
dan menjalankan SET NAMES setelah terhubung ke MySQL.

--memeriksa
Periksa penundaan budak sekali dan keluar. Jika Anda juga menentukan "--recurse", alat akan mencoba
untuk menemukan budak dari budak yang diberikan dan memeriksa dan mencetak lag mereka juga. Itu
nama host atau IP dan port untuk setiap budak dicetak sebelum penundaannya. "--berulang" saja
bekerja dengan MySQL.

--periksa-baca-saja
Periksa apakah server telah mengaktifkan read_only; Jika ya, alat akan melompati melakukan apa pun
sisipan.

--konfigurasi
jenis: Array

Baca daftar file konfigurasi yang dipisahkan koma ini; jika ditentukan, ini harus menjadi yang pertama
pilihan pada baris perintah.

--buat tabel
Buat detak jantung "--tabel" jika tidak ada.

Opsi ini menyebabkan tabel yang ditentukan oleh "--database" dan "--table" dibuat
dengan definisi tabel MAGIC_create_heartbeat berikut:

BUAT TABEL detak jantung (
ts varchar.dll(26) TIDAK NULL,
server_id int unsigned BUKAN KUNCI UTAMA NULL,
fillet varchar.dll(255) NULL DEFAULT, -- TAMPILKAN STATUS MASTER
posisi bigint unsigned DEFAULT NULL, -- SHOW MASTER STATUS
relay_master_log_file varchar.dll(255) NULL DEFAULT, -- TAMPILKAN STATUS BUDAK
exec_master_log_pos bigint unsigned DEFAULT NULL -- TAMPILKAN STATUS BUDAK
);

Tabel detak jantung membutuhkan setidaknya satu baris. Jika Anda membuat detak jantung secara manual
tabel, maka Anda harus menyisipkan baris dengan melakukan:

INSERT INTO detak jantung (ts, server_id) NILAI (SEKARANG(), N);

atau jika menggunakan "--utc":

INSERT INTO detak jantung (ts, server_id) NILAI (UTC_TIMESTAMP(), N);

di mana "N" adalah ID server; jangan gunakan @@server_id karena akan mereplikasi dan
budak akan memasukkan ID server mereka sendiri, bukan ID server master.

Ini dilakukan secara otomatis oleh "--create-table".

Versi lama dari tabel detak jantung masih didukung:

BUAT TABEL detak jantung (
id int BUKAN KUNCI UTAMA NULL,
ts datetime BUKAN NULL
);

Tabel lama tidak mendukung instance "--update" pada setiap slave dari multi-slave
hierarki seperti "master -> slave1 -> slave2". Untuk menyisipkan satu baris yang diperlukan secara manual
ke dalam tabel warisan:

INSERT INTO detak jantung (id, ts) NILAI (1, SEKARANG());

atau jika menggunakan "--utc":

INSERT INTO detak jantung (id, ts) VALUES (1, UTC_TIMESTAMP());

Alat ini secara otomatis mendeteksi jika tabel detak jantung adalah warisan.

Lihat juga "HIERARKI MULTI-BUDA".

--mendaemonisasi
Garpu ke latar belakang dan lepaskan dari shell. Sistem operasi POSIX saja.

--basis data
bentuk pendek: -D; jenis: string

Database yang akan digunakan untuk koneksi.

--dbi-driver
bawaan: mysql; jenis: string

Tentukan driver untuk koneksi; "mysql" dan "Pg" didukung.

--default-file
bentuk pendek: -F; jenis: string

Hanya baca opsi mysql dari file yang diberikan. Anda harus memberikan nama path absolut.

--mengajukan
jenis: string

Cetak keluaran "--monitor" terbaru ke file ini.

Ketika "--monitor" diberikan, mencetak output ke file yang ditentukan alih-alih ke STDOUT.
File dibuka, dipotong, dan ditutup setiap interval, sehingga hanya akan berisi
statistik terbaru. Berguna ketika "--daemonize" diberikan.

--frame
jenis: tali; default: 1m,5m,15m

Jangka waktu untuk rata-rata.

Menentukan kerangka waktu untuk menghitung rata-rata bergerak ketika "--monitor" adalah
diberikan. Tentukan sebagai daftar angka yang dipisahkan koma dengan akhiran. Sufiksnya bisa
s untuk detik, m untuk menit, h untuk jam, atau d untuk hari. Ukuran paling besar
frame menentukan penggunaan memori maksimum, hingga jumlah per detik yang ditentukan
sampel disimpan dalam memori untuk menghitung rata-rata. Anda dapat menentukan sebanyak mungkin
kerangka waktu yang Anda inginkan.

--membantu
Tunjukkan bantuan dan keluar.

--tuan rumah
bentuk pendek: -h; jenis: string

Hubungkan ke tuan rumah.

--[no]masukkan-detak-detak-baris
default: ya

Masukkan baris detak jantung di "--tabel" jika tidak ada.

Detak jantung "--tabel" membutuhkan baris detak jantung, jika tidak, tidak ada yang perlu "--update",
"--monitor", atau "--check"! Secara default, alat akan menyisipkan baris detak jantung jika ada
belum hadir. Anda dapat menonaktifkan fitur ini dengan menentukan
"--no-insert-heartbeat-row" jika pengguna database tidak memiliki hak INSERT.

--selang
jenis: mengapung; standar: 1.0

Seberapa sering memperbarui atau memeriksa detak jantung "--tabel". Pembaruan dan pemeriksaan dimulai pada
seluruh detik pertama kemudian ulangi setiap detik "--interval" untuk "--update" dan setiap
"--interval" plus "--skew" detik untuk "--monitor".

Misalnya, jika pada 00:00.4 instans "--update" dimulai pada interval 0.5 detik,
pembaruan pertama terjadi pada 00:01.0, berikutnya pada 00:01.5, dll. Jika pada 00:10.7 a
Instans "--monitor" dimulai pada interval 0.05 detik dengan default 0.5 detik
"--skew", maka cek pertama terjadi pada 00:11.5 (00:11.0 + 0.5) yang akan menjadi
"--skew" detik setelah pembaruan terakhir yang, karena instance sedang diperiksa di
interval yang disinkronkan, terjadi pada 00:11.0.

Alat menunggu dan mulai pada detik pertama hanya untuk membuat interval
perhitungan lebih sederhana. Oleh karena itu, alat ini dapat menunggu hingga 1 detik sebelum memperbarui
atau memeriksa.

Interval minimum (tercepat) adalah 0.01, dan presisi maksimum adalah dua desimal
tempat, jadi 0.015 akan dibulatkan menjadi 0.02.

Jika tabel detak jantung warisan (lihat "--buat-tabel") digunakan, maka presisi maksimum
adalah 1s karena kolom "ts" bertipe "datetime".

--catatan
jenis: string

Cetak semua output ke file ini saat di-daemon.

--master-server-id
jenis: string

Hitung penundaan dari ID server master ini untuk "--monitor" atau "--check". Jika tidak
diberikan, pt-detak jantung mencoba untuk terhubung ke master server dan menentukan
nomor server.

--memantau
Pantau penundaan budak secara terus menerus.

Menentukan bahwa pt-detak jantung harus memeriksa penundaan budak setiap detik dan melapor ke
STDOUT (atau jika "--file" diberikan, ke file sebagai gantinya). Outputnya adalah arus
penundaan diikuti oleh rata-rata bergerak selama jangka waktu yang diberikan dalam "--frames". Untuk
contoh,

5 detik [ 0.25 detik, 0.05 detik, 0.02 detik]

--kata sandi
bentuk pendek: -p; jenis: string

Kata sandi untuk digunakan saat menghubungkan. Jika kata sandi mengandung koma, mereka harus diloloskan
dengan garis miring terbalik: "ujian\,ple"

--pid
jenis: string

Buat file PID yang diberikan. Alat tidak akan mulai jika file PID sudah ada dan
PID yang dikandungnya berbeda dari PID saat ini. Namun, jika file PID
ada dan PID yang dikandungnya tidak lagi berjalan, alat akan menimpa PID
file dengan PID saat ini. File PID dihapus secara otomatis saat alat keluar.

--Pelabuhan
bentuk pendek: -P; jenis: int

Nomor port yang digunakan untuk koneksi.

--print-master-server-id
Cetak auto-detected atau diberi "--master-server-id". Jika "--check" atau "--monitor" adalah
ditentukan, menentukan opsi ini akan mencetak deteksi otomatis atau diberikan
"--master-server-id" di akhir setiap baris.

--berulang
jenis: int

Periksa budak secara rekursif ke kedalaman ini dalam mode "--check".

Cobalah untuk menemukan server budak secara rekursif, hingga kedalaman yang ditentukan. Setelah menemukan
server, jalankan pemeriksaan pada masing-masing server dan cetak nama host (jika mungkin),
diikuti oleh penundaan budak.

Ini saat ini hanya berfungsi dengan MySQL. Lihat "--rekursi-metode".

--rekursi-metode
jenis: susunan; default: daftar proses, host

Metode rekursi yang disukai digunakan untuk menemukan budak.

Metode yang mungkin adalah:

PENGGUNAAN METODE
===============================
daftar proses TUNJUKKAN DAFTAR PROSES
host TUNJUKKAN HOST BUDAK
tidak ada Jangan temukan budak

Metode daftar proses lebih disukai karena SHOW SLAVE HOSTS tidak dapat diandalkan.
Namun, metode host diperlukan jika server menggunakan port non-standar (tidak
3306). Biasanya pt-detak jantung melakukan hal yang benar dan menemukan budak, tetapi Anda mungkin
berikan metode yang disukai dan itu akan digunakan terlebih dahulu. Jika tidak menemukan budak,
metode lain akan dicoba.

--mengganti
Gunakan "GANTI" alih-alih "PERBARUI" untuk --update.

Saat menjalankan dalam mode "--update", gunakan "GANTI" alih-alih "PERBARUI" untuk menyetel
cap waktu tabel detak jantung. Pernyataan "REPLACE" adalah ekstensi MySQL ke SQL.
Opsi ini berguna saat Anda tidak tahu apakah tabel berisi baris atau tidak.
Itu harus digunakan bersama dengan --update.

--waktu berjalan
jenis: waktu

Saatnya berlari sebelum keluar.

--penjaga
jenis: tali; default: /tmp/pt-detak jantung-sentinel

Keluar jika file ini ada.

--set-vars
jenis: Array

Setel variabel MySQL dalam daftar pasangan "variabel=nilai" yang dipisahkan koma ini.

Secara default, set alat:

tunggu_waktu habis=10000

Variabel yang ditentukan pada baris perintah menggantikan default ini. Sebagai contoh,
menentukan "--set-vars wait_timeout=500" mengesampingkan nilai default 10000.

Alat ini mencetak peringatan dan melanjutkan jika variabel tidak dapat disetel.

--condong
jenis: mengapung; standar: 0.5

Berapa lama untuk menunda pemeriksaan.

Standarnya adalah untuk menunda pemeriksaan satu setengah detik. Karena pembaruan terjadi segera setelah
mungkin setelah awal detik pada master, ini memungkinkan satu setengah detik
penundaan replikasi sebelum melaporkan bahwa slave tertinggal satu detik dari master.
Jika jam Anda tidak sepenuhnya akurat atau ada alasan lain yang Anda inginkan
menunda budak lebih atau kurang, Anda dapat men-tweak nilai ini. Coba setting "PTDEBUG"
variabel lingkungan untuk melihat efeknya.

--stopkontak
Surat pendek; jenis: string

File soket yang akan digunakan untuk koneksi.

--berhenti
Hentikan menjalankan instance dengan membuat file sentinel.

Ini seharusnya memiliki efek menghentikan semua instance yang sedang berjalan yang sedang menonton
file penjaga yang sama. Jika tidak ada "--update", "--monitor" atau "--check" yang ditentukan,
"pt-heartbeat" akan keluar setelah membuat file. Jika salah satunya ditentukan,
"pt-heartbeat" akan menunggu interval yang diberikan oleh "--interval", lalu hapus file dan
lanjut bekerja.

Anda mungkin menemukan ini berguna untuk menghentikan pekerjaan cron dengan anggun jika perlu, atau untuk menggantinya
menjalankan instance dengan yang lain. Misalnya, jika Anda ingin berhenti dan memulai kembali
"pt-detak jantung" setiap jam (hanya untuk memastikan bahwa itu dimulai ulang setiap jam, untuk berjaga-jaga
server crash atau masalah lain), Anda dapat menggunakan baris "crontab" seperti ini:

0 * * * * pt-detak jantung --update -D test --stop \
--sentinel /tmp/pt-detak jantung-jam

Non-default "--sentinel" akan memastikan pekerjaan "cron" per jam hanya menghentikan instance
sebelumnya dimulai dengan opsi yang sama (yaitu, dari pekerjaan "cron" yang sama).

Lihat juga "--sentinel".

--meja
jenis: tali; default: detak jantung

Tabel yang digunakan untuk detak jantung.

Jangan tentukan database.table; gunakan "--database" untuk menentukan database.

Lihat "--buat-tabel".

--memperbarui
Perbarui detak jantung master.

--pengguna
bentuk pendek: -u; jenis: string

Pengguna untuk login jika bukan pengguna saat ini.

--UTC
Abaikan zona waktu sistem dan gunakan hanya UTC. Secara default pt-detak jantung tidak memeriksa atau
sesuaikan untuk sistem yang berbeda atau zona waktu MySQL yang dapat menyebabkan alat untuk menghitung
lagnya salah. Menentukan opsi ini adalah ide yang bagus karena memastikan bahwa
alat bekerja dengan benar terlepas dari zona waktu.

Jika digunakan, opsi ini harus digunakan untuk semua instance pt-heartbeat: "--update",
"--monitor", "--check", dll. Anda mungkin harus mengatur opsi dalam file "--config".
Mencampur opsi ini dengan instance pt-heartbeat yang tidak menggunakan opsi ini akan menyebabkan kesalahan
pembacaan lag positif karena zona waktu yang berbeda (kecuali semua sistem Anda disetel ke
gunakan UTC, dalam hal ini opsi ini tidak diperlukan).

--Versi: kapan
Tampilkan versi dan keluar.

--[no]versi-periksa
default: ya

Periksa versi terbaru Percona Toolkit, MySQL, dan program lainnya.

Ini adalah fitur standar "periksa pembaruan secara otomatis", dengan dua tambahan
fitur. Pertama, alat ini memeriksa versi program lain di sistem lokal di
tambahan untuk versinya sendiri. Misalnya, ia memeriksa versi setiap server MySQL
itu terhubung ke, Perl, dan modul Perl DBD::mysql. Kedua, ia memeriksa dan memperingatkan
tentang versi dengan masalah yang diketahui. Misalnya, MySQL 5.5.25 memiliki bug kritis dan
dirilis ulang sebagai 5.5.25a.

Setiap pembaruan atau masalah yang diketahui dicetak ke STDOUT sebelum keluaran normal alat.
Fitur ini tidak boleh mengganggu pengoperasian normal alat.

Untuk informasi lebih lanjut, kunjungi .

DSN PILIHAN

Opsi DSN ini digunakan untuk membuat DSN. Setiap opsi diberikan seperti "opsi = nilai".
Opsi peka huruf besar/kecil, jadi P dan p bukan opsi yang sama. Tidak mungkin ada
spasi putih sebelum atau sesudah "=" dan jika nilainya mengandung spasi, itu harus dikutip.
Opsi DSN dipisahkan dengan koma. Lihat halaman manual percona-toolkit untuk detail lengkap.

· SEBUAH

dsn: rangkaian karakter; salinan: ya

Kumpulan karakter default.

· D

dsn: basis data; salinan: ya

Basis data bawaan.

· F

dsn: mysql_read_default_file; salinan: ya

Hanya baca opsi default dari file yang diberikan

· H

dsn: tuan rumah; salinan: ya

Hubungkan ke tuan rumah.

· P

dsn: kata sandi; salinan: ya

Kata sandi untuk digunakan saat menghubungkan. Jika kata sandi mengandung koma, mereka harus diloloskan
dengan garis miring terbalik: "ujian\,ple"

· P

dsn: pelabuhan; salinan: ya

Nomor port yang digunakan untuk koneksi.

· S

dsn: mysql_socket; salinan: ya

File soket yang akan digunakan untuk koneksi.

· kamu

dsn: pengguna; salinan: ya

Pengguna untuk login jika bukan pengguna saat ini.

LINGKUNGAN

Variabel lingkungan "PTDEBUG" memungkinkan keluaran debugging verbose ke STDERR. Untuk mengaktifkan
debugging dan tangkap semua output ke file, jalankan alat seperti:

PTDEBUG=1 pt-detak jantung ... > FILE 2>&1

Hati-hati: keluaran debug sangat banyak dan dapat menghasilkan beberapa megabita keluaran.

PELACAKAN PENGIRIMAN PERSYARATAN

Anda memerlukan Perl, DBI, DBD::mysql, dan beberapa paket inti yang harus diinstal di
versi Perl yang cukup baru.

Gunakan pt-heartbeatp online menggunakan layanan onworks.net