xymon - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

xymon - Chương trình giao tiếp khách hàng Xymon

SYNOPSIS

xymon [tùy chọn] NGƯỜI NHẬN tin nhắn

MÔ TẢ

xymon(1) là chương trình khách dùng để giao tiếp với máy chủ Xymon. Nó thường xuyên
được sử dụng bởi hệ thống máy khách Xymon để gửi thông báo trạng thái và cảnh báo máy nhắn tin trong các bài kiểm tra cục bộ.

Trong Xymon, chương trình xymon cũng được sử dụng cho các mục đích quản trị, ví dụ: đổi tên hoặc
xóa máy chủ hoặc để tắt máy chủ bị ngừng hoạt động trong thời gian dài hơn.

LỰA CHỌN VÀ THÔNG SỐ

--gỡ lỗi
Bật gỡ lỗi. Điều này in ra chi tiết về cách kết nối với Xymon
máy chủ đang được thiết lập.

--proxy =http://PROXYSERVER:CỔNG GIAO THỨC/
Khi gửi thông báo trạng thái qua HTTP, hãy sử dụng máy chủ này làm proxy HTTP thay thế
kết nối trực tiếp với máy chủ Xymon.

--timeout = N
Chỉ định thời gian chờ để kết nối với máy chủ Xymon, tính bằng giây. Mặc định
là 5 giây.

--phản ứng
Tiện ích xymon thường biết khi nào cần phản hồi từ máy chủ, vì vậy điều này
tùy chọn không bắt buộc. Tuy nhiên, nó sẽ gây ra bất kỳ phản hồi nào từ máy chủ
hiển thị.

- hợp nhất
Hợp nhất văn bản thông báo dòng lệnh với dữ liệu được cung cấp trên đầu vào chuẩn, và
gửi kết quả đến máy chủ Xymon. Nội dung tin nhắn được cung cấp trên dòng lệnh
trở thành dòng đầu tiên của thông báo đã hợp nhất.

NGƯỜI NHẬN
Sản phẩm NGƯỜI NHẬN tham số xác định máy chủ nào nhận được thông báo. Nếu RECIPIENT là
được đưa ra là "0.0.0.0", sau đó thông báo được gửi đến tất cả các máy chủ được liệt kê trong
Biến môi trường XYMSERVERS.

Thông thường, khách hàng sẽ sử dụng "$ XYMSRV" cho NGƯỜI NHẬN tham số, vì đây là
được xác định để các tập lệnh máy khách tự động chứa giá trị chính xác.

Sản phẩm NGƯỜI NHẬN tham số có thể là một URL cho một máy chủ web có xymoncgimsg.cgi
hoặc tập lệnh tương tự được cài đặt. Điều này tạo đường hầm cho các thông điệp Xymon tới máy chủ Xymon
sử dụng giao thức HTTP tiêu chuẩn. Các xymoncgimsg.cgi(8) Công cụ CGI (có trong Xymon)
phải được cài đặt trên máy chủ web để truyền tải HTTP hoạt động.

THÔNG ĐIỆP
Sản phẩm tin nhắn tham số là thông báo được gửi đến máy chủ Xymon.
Thông điệp phải được đặt trong dấu ngoặc kép, nhưng làm như vậy chúng có thể kéo dài nhiều dòng.
Kích thước tối đa của một tin nhắn được xác định bằng độ dài tối đa cho phép của
dòng lệnh của shell, và thường là 8-32 KB.

Nếu bạn cần gửi thông báo trạng thái dài hơn, bạn có thể chỉ định "@" làm thông báo:
xymon sau đó sẽ đọc thông báo trạng thái từ stdin của nó.

XYMON THÔNG ĐIỆP TỔNG HỢP

Phần này liệt kê các thông báo được sử dụng phổ biến nhất trong giao thức Xymon.

Mỗi thông báo phải bắt đầu bằng một trong các lệnh Xymon. Trường hợp HOSTNAME được chỉ định, nó
phải có bất kỳ dấu chấm nào trong tên máy chủ được thay đổi thành dấu phẩy nếu cài đặt Xymon FQDN được bật
(là mặc định). Vì vậy, máy chủ lưu trữ "www.foo.com", chẳng hạn, sẽ báo cáo là
"www, foo, com".

trạng thái [+ LIFETIME] [/ group: GROUP] HOSTNAME.TESTNAME COLOR
Điều này sẽ gửi thông báo trạng thái cho một bài kiểm tra (cột) trên một máy chủ duy nhất.
TESTNAME là tên của cột nơi kiểm tra này sẽ hiển thị; bất kỳ tên nào đều hợp lệ
ngoại trừ việc sử dụng dấu chấm trong tên thử nghiệm sẽ không hoạt động. COLOR phải là một trong những
màu hợp lệ: "xanh lá cây", "vàng", "đỏ" hoặc "rõ ràng". Các màu "xanh lam" và "tím"
- mặc dù các màu hợp lệ - không nên được gửi trong thông báo trạng thái, vì đây là
được xử lý đặc biệt bởi máy chủ Xymon. Như một trường hợp đặc biệt (để hỗ trợ người già
khách hàng), "khách hàng" có thể được sử dụng làm tên của màu sắc. Điều này gây ra tình trạng
thông báo sẽ được Xymon xử lý dưới dạng thông báo dữ liệu "máy khách" và TESTNAME
tham số được sử dụng làm "id bộ sưu tập".
"Văn bản bổ sung" thường bao gồm dấu thời gian cục bộ và bản tóm tắt của bài kiểm tra
kết quả trên dòng đầu tiên. Bất kỳ dòng nào sau dòng đầu tiên là dạng tự do và có thể
bao gồm bất kỳ thông tin nào có thể hữu ích để chẩn đoán sự cố đang được báo cáo.
LIFETIME xác định thời gian trạng thái này có hiệu lực sau khi được
Máy chủ Xymon. Mặc định là 30 phút, nhưng bạn có thể đặt bất kỳ khoảng thời gian nào bạn muốn. Ví dụ
đối với thử nghiệm tùy chỉnh chạy mỗi giờ một lần, bạn sẽ muốn đặt giá trị này thành ít nhất 60
phút - nếu không trạng thái sẽ chuyển sang màu tím sau 30 phút. Ý kiến ​​đó hay đấy
để đặt LIFETIME dài hơn một chút so với khoảng thời gian giữa các lần kiểm tra của bạn, để
cho phép các thay đổi trong thời gian cần để thử nghiệm của bạn hoàn thành. LIFETIME đang ở trong
phút, trừ khi bạn thêm "h" (giờ), "d" (ngày) hoặc "w" (tuần) ngay sau
số, ví dụ: "trạng thái + 5 giờ" cho một trạng thái có giá trị trong 5 giờ.
Tùy chọn GROUP được sử dụng để hướng các cảnh báo từ trạng thái đến một nhóm cụ thể. Nó
hiện được sử dụng cho trạng thái được tạo từ dữ liệu của khách hàng Xymon, ví dụ: để chỉ đạo
cảnh báo về trạng thái "procs" cho những người khác nhau, tùy thuộc vào chính xác quá trình nào
đang giảm.

thông báo cho HOSTNAME.TESTNAME
Điều này kích hoạt một thông điệp thông tin được gửi đến những người nhận được thông báo về
kết hợp HOSTNAME + TESTNAME này, theo các quy tắc được xác định trong cảnh báo.cfg(5)
Điều này được sử dụng bởi Grantdis.cgi(1) công cụ thông báo cho mọi người về việc máy chủ bị vô hiệu hóa
hoặc được kích hoạt, nhưng cũng có thể dùng như một cách chung để thông báo cho quản trị viên máy chủ.

dữ liệu HOSTNAME.DATANAME
Thông báo "dữ liệu" cho phép các công cụ gửi dữ liệu về máy chủ lưu trữ mà không cần xuất hiện dưới dạng
một cột trên các trang web Xymon. Ví dụ, điều này được sử dụng để báo cáo thống kê
về một máy chủ, ví dụ: dữ liệu vmstat, bản thân nó không đại diện cho một cái gì đó
có màu đỏ, vàng hoặc xanh lá cây. Nó được sử dụng bởi các mô-đun nạp đáy RRD, trong số
khác. Trong Xymon, các thông báo dữ liệu theo mặc định chỉ được xử lý bởi xymond_rrd(8)
mô-đun. Nếu bạn muốn xử lý tin nhắn dữ liệu bằng ứng dụng bên ngoài, bạn có thể
muốn kích hoạt xymond_filestore(8) mô-đun cho thông điệp dữ liệu, để lưu trữ dữ liệu-
tin nhắn ở định dạng tương thích với cách hoạt động của trình nền Big Brother.

tắt HOSTNAME.TESTNAME DURATION
Tắt một bài kiểm tra cụ thể trong DURATION phút. Điều này sẽ gây ra tình trạng này
kiểm tra được liệt kê là "xanh lam" trên máy chủ Xymon và không có cảnh báo nào cho máy chủ / thử nghiệm này
sẽ được tạo. Nếu DURATION được cho dưới dạng một số theo sau là s / m / h / d, thì nó là
được hiểu là giây / phút / giờ / ngày tương ứng. Để vô hiệu hóa một
kiểm tra cho đến khi nó trở nên OK, sử dụng "-1" làm DURATION. Để tắt tất cả các bài kiểm tra cho một
máy chủ, sử dụng dấu hoa thị "*" cho TESTNAME.

bật HOSTNAME.TESTNAME
Bật lại kiểm tra đã bị vô hiệu hóa.

truy vấn HOSTNAME.TESTNAME
Truy vấn máy chủ Xymon để biết trạng thái mới nhất được báo cáo cho thử nghiệm cụ thể này. Nếu như
trạng thái máy chủ / kiểm tra đã biết, phản hồi là dòng đầu tiên của báo cáo trạng thái
- màu hiện tại sẽ là từ đầu tiên trên dòng. Các dòng văn bản bổ sung
mà có thể có trên thông báo trạng thái không thể được truy xuất.
Điều này cho phép bất kỳ ứng dụng Xymon nào xác định trạng thái của một thử nghiệm cụ thể, cho dù
nó liên quan đến máy chủ lưu trữ nơi máy khách đang chạy, một số máy chủ lưu trữ khác, hoặc
có lẽ là kết quả của một thử nghiệm kết hợp từ nhiều máy chủ được quản lý bởi trạng thái kết hợp(1)
Điều này thường sẽ hữu ích cho các tập lệnh mở rộng máy khách Xymon, cần phải
xác định trạng thái của các máy chủ khác, chẳng hạn, để quyết định xem máy chủ tự động
hành động khôi phục nên được bắt đầu.

cấu hình FILENAME
Truy xuất một trong các tệp cấu hình Xymon từ máy chủ. Lệnh này cho phép
một ứng dụng khách để kéo các tệp từ thư mục $ XYMONHOME / etc / trên máy chủ, cho phép
để cập nhật bán tự động cấu hình máy khách. Kể từ khi cấu hình
các tệp được thiết kế để có một tệp chung cho cấu hình của tất cả các máy chủ trong
hệ thống - và trên thực tế đây là cách được đề xuất để định cấu hình máy khách của bạn - đây
giúp cho việc đồng bộ hóa các tệp cấu hình dễ dàng hơn.

thả HOSTNAME
Xóa tất cả dữ liệu được lưu trữ về máy chủ HOSTNAME. Người ta cho rằng bạn có
đã xóa máy chủ khỏi tệp cấu hình hosts.cfg.

thả HOSTNAME TESTNAME
Xóa dữ liệu về một thử nghiệm (cột) duy nhất.

đổi tên OLDHOSTNAME NEWHOSTNAME
Đổi tên tất cả dữ liệu cho một máy chủ đã được thay đổi tên. Bạn nên làm điều này sau khi
thay đổi tên máy chủ trong tệp cấu hình hosts.cfg.

đổi tên HOSTNAME OLDTESTNAME NEWTESTNAME
Đổi tên dữ liệu về một thử nghiệm đơn lẻ (cột).

xymondlog HOSTNAME.TESTNAME
Truy xuất nhật ký trạng thái Xymon cho một lần kiểm tra. Dòng đầu tiên của phản hồi
chứa một loạt các trường được phân tách bằng dấu sổ:

hostname Tên của máy chủ

tên kiểm tra Tên của bài kiểm tra

màu sắc Màu trạng thái (xanh lá cây, vàng, đỏ, xanh lam, trong, tím)

cờ kiểm tra Đối với các bài kiểm tra mạng, các cờ chỉ ra chi tiết về bài kiểm tra (được sử dụng bởi
xymongen).

sự thay đổi cuối cùng Dấu thời gian Unix khi màu trạng thái thay đổi lần cuối.

thời gian đăng nhập Dấu thời gian Unix khi nhận được thông báo nhật ký.

thời gian hợp lệ Dấu thời gian Unix khi thông báo nhật ký không còn hợp lệ (nó chuyển sang màu tím lúc
thời gian này).

giờ hành chính Dấu thời gian -1 hoặc Unix khi một xác nhận hoạt động hết hạn.

thời gian vô hiệu hóa Dấu thời gian -1 hoặc Unix khi trạng thái không còn bị vô hiệu hóa.

người gửi Địa chỉ IP nơi nhận trạng thái.

Cookie -1 hoặc giá trị cookie được sử dụng để xác nhận cảnh báo.

xác nhận Rỗng hoặc thông báo xác nhận được gửi khi trạng thái được xác nhận.
Dòng mới, dấu sổ và dấu gạch chéo ngược được thoát bằng dấu gạch chéo ngược, kiểu C.

gỡ bỏ Rỗng hoặc tin nhắn được gửi khi trạng thái bị vô hiệu hóa. Dòng mới, dấu ống
và dấu gạch chéo ngược được thoát bằng dấu gạch chéo ngược, kiểu C.

Sau dòng đầu tiên là nhật ký trạng thái đầy đủ ở định dạng văn bản thuần túy.

xymondxlog HOSTNAME.TESTNAME
Truy xuất một chuỗi XML có chứa nhật ký trạng thái như với lệnh "xymondlog".

xymondboard [CRITERIA] [fields = FIELDLIST]
Truy xuất bản tóm tắt về trạng thái của tất cả các bài kiểm tra đã biết có sẵn cho daemon Xymon.

Theo mặc định - nếu không có CRITERIA nào được cung cấp - nó trả về một dòng cho tất cả trạng thái
tin nhắn được tìm thấy trong Xymon. Bạn có thể lọc câu trả lời theo lựa chọn cụ thể
trang, máy chủ lưu trữ, thử nghiệm, màu sắc hoặc nhiều lĩnh vực khác. PAGEPATH, NETWORK, HOSTNAME,
Các tham số TESTNAME và * MSG được hiểu là các biểu thức chính quy tương thích với perl;
tham số COLOR chấp nhận nhiều màu được phân tách bằng dấu phẩy; các giá trị * TIME
chấp nhận dấu thời gian kỷ nguyên unix. Các biến khác được xác định trong xymon-xmh(5) cũng có thể
được dùng.

Bởi vì lọc máy chủ được thực hiện trước khi lọc thử nghiệm, nó hiệu quả hơn (với
tập dữ liệu rất lớn) để sử dụng PAGEPATH, HOSTNAME, NETWORK và các bộ lọc XMH_ khác
khi có thể, trước khi lọc toàn cầu bằng COLOR, * MSG, * TIME hoặc TESTNAME.

Ví dụ, bạn có thể lọc cả tên máy chủ và tên thử nghiệm.

trang = PAGEPATH Chỉ bao gồm các bài kiểm tra từ các máy chủ được tìm thấy trên trang PAGEPATH trong
tệp hosts.cfg.

net = NETWORK Chỉ bao gồm các bài kiểm tra từ các máy chủ có thẻ NET: này

ip = IPĐịa chỉ Chỉ bao gồm các bài kiểm tra từ các máy chủ có địa chỉ IP này. Đây là một regex,
không phải CIDR.

máy chủ = HOSTNAME Chỉ bao gồm các bài kiểm tra từ máy chủ HOSTNAME

test = TESTNAME Chỉ bao gồm các thử nghiệm với tên thử nghiệm TESTNAME

color = COLORNAME Chỉ bao gồm các thử nghiệm có màu trạng thái là COLORNAME

tag = TAGNAME Chỉ bao gồm các máy chủ có một thẻ nhất định được chỉ định trong máy chủ.cfg(5)
hàng. Lưu ý rằng chỉ các mục được biết đến với các thành phần xymon mới được đưa vào đây; Bất kỳ
văn bản không được bao gồm

XMH_string = VALUE Chỉ bao gồm các máy chủ có xymon-xmh(5) biến phù hợp với điều này
giá trị

Lọc nâng cao

msg = MESSAGE Chỉ bao gồm các bài kiểm tra có nội dung đầy đủ phù hợp với MESSAGE. Sử dụng "\ s" để
không gian thoát (hoặc chuỗi PCRE khác)

ackmsg = MESSAGE Chỉ bao gồm các bài kiểm tra có (các) xác nhận MESSAGE. Sử dụng "\ s" để
không gian thoát (hoặc chuỗi PCRE khác)

dismsg = MESSAGE Chỉ bao gồm các bài kiểm tra đã bị vô hiệu hóa với các chuỗi đối sánh
NHẮN. Sử dụng "\ s" để thoát dấu cách (hoặc các chuỗi PCRE khác). (Nó là hiệu quả nhất
để ghép nối cái này với color = blue.)

Bộ lọc dấu thời gian

Một số trường nhất định (được giải thích bên dưới) có thể được lọc bằng dấu thời gian unix và với
các bất đẳng thức sau:> => <= <=! =

Các bộ lọc này là: lastchange, logtime, validtime, acktime, disabletime

Phản hồi là một dòng cho mỗi trạng thái phù hợp với CRITERIA hoặc tất cả các trạng thái
nếu không có tiêu chí nào được chỉ định. Dòng này bao gồm một số trường, được phân tách
bằng một dấu ống. Bạn có thể chọn các trường để truy xuất bằng cách liệt kê chúng trong
DANH SÁCH CÁC TRƯỜNG. Các trường sau có sẵn:

hostname Tên của máy chủ

tên kiểm tra Tên của bài kiểm tra

màu sắc Màu trạng thái (xanh lá cây, vàng, đỏ, xanh lam, trong, tím)

cờ Đối với các bài kiểm tra mạng, các cờ chỉ ra chi tiết về bài kiểm tra (được sử dụng bởi
xymongen).

sự thay đổi cuối cùng Dấu thời gian Unix khi màu trạng thái thay đổi lần cuối.

thời gian đăng nhập Dấu thời gian Unix khi nhận được thông báo nhật ký.

thời gian hợp lệ Dấu thời gian Unix khi thông báo nhật ký không còn hợp lệ (nó chuyển sang màu tím lúc
thời gian này).

giờ hành chính Dấu thời gian -1 hoặc Unix khi một xác nhận hoạt động hết hạn.

thời gian vô hiệu hóa Dấu thời gian -1 hoặc Unix khi trạng thái không còn bị vô hiệu hóa.

người gửi Địa chỉ IP nơi nhận trạng thái.

Cookie -1 hoặc giá trị cookie được sử dụng để xác nhận cảnh báo.

dòng 1 Dòng đầu tiên của nhật ký trạng thái.

xác nhận Rỗng (nếu không có xác nhận nào đang hoạt động) hoặc văn bản của xác nhận
thông điệp.

gỡ bỏ Rỗng (nếu trạng thái hiện đang được bật) hoặc văn bản của việc tắt
thông điệp.

msg Nội dung đầy đủ của thông báo trạng thái hiện tại.

khách hàng Hiển thị "Y" nếu có sẵn dữ liệu khách hàng, "N" nếu không.

clntstamp Dấu thời gian khi nhận được tin nhắn khách hàng cuối cùng, trong Unix "epoch"
định dạng.

danh sách xác nhận Danh sách các xác nhận hiện tại cho một bài kiểm tra. Đây là một chuỗi văn bản với
nhiều trường, được phân tách bằng ký tự dấu hai chấm. Có 5 trường: Dấu thời gian cho
khi nào ack được tạo và khi nó hết hạn; "cấp độ ack"; người dùng
đã gửi ack; và văn bản xác nhận.

flinfo Cho biết trạng thái có đang vỗ hay không. 5 trường, được phân tách bằng "/": A "0" nếu
trạng thái không vỗ và "1" nếu nó đang vỗ; dấu thời gian khi trạng thái mới nhất
sự thay đổi đã được ghi lại và khi sự thay đổi trạng thái đầu tiên được ghi lại; và hai
màu sắc mà trạng thái đang thay đổi.

số liệu thống kê Số lượng thay đổi trạng thái đã được ghi lại cho trạng thái này kể từ xymond
đa băt đâu.

bổ ngữ Liệt kê tất cả các công cụ sửa đổi đang hoạt động cho trạng thái này (tức là các bản cập nhật được gửi bằng cách sử dụng
lệnh "sửa đổi").

XMH_ * Các thẻ XMH đề cập đến Xymon máy chủ.cfg(5) thiết lập cấu hình. Một đầy đủ
danh sách những thứ này có thể được tìm thấy trong xymon-xmh(5) trang người.

Các trường ackmsg, dismsg và msg có một số ký tự được mã hóa: Dòng mới là "\ n",
TAB là "\ t", ký tự xuống dòng là "\ r", dấu gạch ngang là "\ p" và dấu gạch chéo ngược là "\\".

Nếu tham số "fields" bị bỏ qua, một tập hợp mặc định là
tên máy chủ, tên kiểm tra, màu sắc, cờ, thay đổi cuối cùng, thời gian đăng nhập, thời gian hợp lệ, acktime, thời gian tắt, người gửi, cookie, line1
Được sử dụng.

xymondxboard
Truy xuất một chuỗi XML với bản tóm tắt của tất cả các nhật ký trạng thái như đối với
lệnh "xymondboard".

hostinfo [TIÊU CHÍ]
Truy xuất cấu hình hiện tại của máy chủ (tức là máy chủ.cfg(5) Định nghĩa).
CRITERIA chọn (các) máy chủ để báo cáo và giống với CRITERIA trong
lệnh xymondboard.

Phản hồi là một dòng cho mỗi máy chủ phù hợp với CRITERIA hoặc tất cả các máy chủ nếu
không có tiêu chí nào được chỉ định. Dòng này bao gồm một số trường, được phân tách bằng
một dấu ống. Hai trường đầu tiên sẽ luôn là tên máy chủ và địa chỉ IP.
Các trường còn lại - nếu có - là các thẻ hosts.cfg không theo thứ tự cụ thể.

tải xuống FILENAME
Tải xuống tệp từ thư mục tải xuống của máy chủ Xymon.

khách hàng [/ COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
Được sử dụng để gửi thông báo "máy khách" đến máy chủ Xymon. Tin nhắn khách hàng được tạo
bởi khách hàng Xymon; khi được gửi đến máy chủ Xymon, chúng được so khớp với
quy tắc trong phân tích.cfg(5) tệp cấu hình và thông báo trạng thái được tạo
cho các bài kiểm tra phía máy khách. COLLECTORID được sử dụng khi gửi dữ liệu máy khách
là những bổ sung cho dữ liệu khách hàng tiêu chuẩn. Dữ liệu sẽ được nối với
dữ liệu khách hàng bình thường.

clientlog HOSTNAME [section = SECTIONNAME [, SECTIONNAME ...]]
Truy xuất thông báo khách hàng thô hiện tại được gửi lần cuối bởi HOSTNAME. Tùy chọn
bộ lọc "section" được sử dụng để chọn các phần cụ thể của dữ liệu khách hàng.

ping Cố gắng liên hệ với máy chủ Xymon. Nếu thành công, ID phiên bản máy chủ Xymon là
báo cáo.

khách hàng kéo
Thông báo này được sử dụng khi tìm nạp dữ liệu máy khách thông qua cơ chế "kéo" được triển khai
by xymonfetch(8) và bộ đệm thông điệp(8) cho các máy khách không thể kết nối trực tiếp với
Máy chủ Xymon.

danh sách ma quái
Báo cáo danh sách ma các khách hàng mà máy chủ Xymon nhìn thấy. Ma là hệ thống
báo cáo dữ liệu cho máy chủ Xymon, nhưng không được liệt kê trong tệp hosts.cfg.

lên lịch [TIMESTAMP COMMAND]
Lên lịch một lệnh được gửi đến máy chủ Xymon để thực thi sau đó. Ví dụ
được sử dụng để lên lịch tắt máy chủ hoặc dịch vụ vào một lúc nào đó trong tương lai. YÊU CẦU
là một lệnh Xymon hoàn chỉnh, chẳng hạn như những lệnh được liệt kê ở trên. TIMESTAMP là Unix
khoảng thời gian khi lệnh sẽ được thực thi.
Nếu không có tham số nào được đưa ra, thì các tác vụ được lập lịch hiện tại được liệt kê trong
phản ứng. Phản hồi là một dòng cho mỗi lệnh được lập lịch, với id công việc,
thời gian khi lệnh sẽ được thực thi, địa chỉ IP mà từ đó lệnh được gửi,
và chuỗi lệnh đầy đủ.
Để hủy một lệnh đã lên lịch trước đó, "lịch trình hủy bỏ VIỆC LÀM " có thể được sử dụng.
JOBID là một số được cung cấp dưới dạng mục đầu tiên trong đầu ra từ danh sách lịch biểu.

ghi chú FILENAME
Nội dung tin nhắn sẽ được lưu trữ trong $ XYMONHOME / Notes / FILENAME, sau đó được sử dụng làm
siêu liên kết từ tên máy chủ hoặc tên cột. Điều này yêu cầu tác vụ "lưu ý"
được bật trong task.cfg (nó bị tắt theo mặc định). FILENAME không được chứa bất kỳ
đường dẫn thư mục - chúng tự động bị loại bỏ.

ID người dùng
Các thông báo này sẽ được chuyển tiếp trực tiếp đến các mô-đun đang nghe trên kênh "người dùng"
của daemon Xymon. Điều này nhằm mục đích giao tiếp tùy chỉnh giữa phía máy khách
mô-đun và máy chủ Xymon.

sửa đổi HOSTNAME.TESTNAME NGUYÊN NHÂN NGUỒN MÀU
Sửa đổi màu của một trạng thái cụ thể mà không tạo ra trạng thái hoàn chỉnh
nhắn. Điều này dành cho các bộ xử lý phụ trợ (ví dụ: đồ thị RRD) có thể ghi đè
màu sắc của trạng thái dựa trên một số tiêu chí được xác định bên ngoài luồng thông thường của một
trạng thái. Ví dụ: trạng thái "conn" bình thường có thể có màu xanh lục vì nó chỉ kiểm tra
về việc máy chủ có thể được ping hay không; trình xử lý RRD sau đó có thể sử dụng "sửa đổi"
lệnh ghi đè, đây là thời gian phản hồi ping thực tế vượt quá ngưỡng nhất định.
(Xem cài đặt cấu hình "DS" trong phân tích.cfg(5) để biết cách thực hiện điều này). NGUỒN
là một số nhận dạng của mô-đun tạo ra thông báo "sửa đổi" - tương lai
sửa đổi phải sử dụng cùng một nguồn. Có thể có một số nguồn sửa đổi
cùng một trạng thái (trạng thái nghiêm trọng nhất sau đó trở thành màu thực của
trạng thái). CAUSE là một chuỗi văn bản một dòng giải thích lý do ghi đè
màu trạng thái bình thường - nó sẽ được hiển thị trên trang web trạng thái.

THÍ DỤ

Gửi thông báo trạng thái bình thường đến máy chủ Xymon, sử dụng giao thức Xymon tiêu chuẩn trên TCP
cảng 1984:
$ $ XYMON $ XYMSRV "trạng thái www, foo, com.http xanh` date` Web OK "

Gửi cùng một thông báo trạng thái, nhưng sử dụng giao thức HTTP qua xymoncgimsg.cgi của máy chủ web
kịch bản:
$ $ XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "trạng thái www, foo, com.http xanh lục
`date` Web OK"

Sử dụng thông báo "truy vấn" để xác định màu của bài kiểm tra "www" và khởi động lại Apache nếu nó
màu đỏ:

$ WWW = `$ XYMON $ XYMSRV" truy vấn www, foo, com.www "| awk '{print $ 1}' '
$ if ["$ WWW" = "red"]; sau đó /etc/init.d/apache khởi động lại; fi

Sử dụng thông báo "config" để cập nhật tệp mytest.cfg cục bộ (nhưng chỉ khi chúng tôi nhận được phản hồi):

$ $ XYMON $ XYMSRV "cấu hình mytest.cfg"> /tmp/mytest.cfg.new
$ if [-s /tmp/mytest.cfg.new]; sau đó
mv /tmp/mytest.cfg.new $ XYMONHOME / etc / mytest.cfg
fi

Gửi một thông báo trạng thái rất lớn đã được tạo sẵn trong tệp "statusmsg.txt". Thay thế
cung cấp nó trên dòng lệnh, hãy chuyển nó qua stdin đến lệnh xymon:

$ cat statusmsg.txt | $ XYMON $ XYMSRV "@"

Sử dụng xymon trực tuyến bằng các dịch vụ onworks.net