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

CHƯƠNG TRÌNH:

TÊN

pmlogrewrite - viết lại kho lưu trữ Performance Co-Pilot

SYNOPSIS

$PCP_BINADM_DIR/pmlogrewrite [-Cdiqsvw ] [-c cấu hình] đăng nhập [đăng xuất]

MÔ TẢ

pmlogrewrite đọc nhật ký lưu trữ Đồng thí điểm hiệu suất (PCP) được xác định bởi đăng nhập và
tạo đăng nhập lưu trữ PCP đăng xuất. Trong điều kiện sử dụng bình thường, -c tùy chọn sẽ được sử dụng để
chỉ định một tệp cấu hình hoặc các tệp có chứa thông số kỹ thuật (xem VIẾT LẠI
QUY TẮC TỔNG HỢP phần bên dưới) mô tả cách dữ liệu và siêu dữ liệu từ đăng nhập nên là
chuyển hóa để sản xuất đăng xuất.

Công dụng điển hình của pmlogrewrite sẽ phù hợp với sự phát triển của Hiệu suất
Đại lý miền số liệu (PMDA) trong đó tên, siêu dữ liệu và ngữ nghĩa của số liệu và chúng
các miền phiên bản được liên kết có thể thay đổi theo thời gian, ví dụ: quảng cáo loại số liệu từ
số nguyên 32 bit thành số nguyên 64 bit hoặc đổi tên một nhóm số liệu. Tham khảo đến VÍ DỤ
phần dành cho một số trường hợp sử dụng bổ sung.

pmlogrewrite hữu ích nhất khi PMDA thay đổi hoặc có lỗi trong môi trường sản xuất,
dẫn đến các kho lưu trữ không thể kết hợp với pmlogextract(1). Bằng cách xử lý trước
lưu trữ với pmlogrewrite các kho lưu trữ kết quả có thể được hợp nhất với
pmlogextract(1).

Đầu vào đăng nhập phải là nhật ký lưu trữ PCP được tạo bởi pmlogger(1), hoặc có thể là một trong
các công cụ đọc và tạo các kho lưu trữ PCP, ví dụ: pmlogextract(1) pmlogreduce(1).

Nếu không -c tùy chọn được chỉ định thì hành vi mặc định chỉ cần tạo đăng xuất như một bản sao của
đăng nhập. Điều này phức tạp hơn một chút so với làm sao(1), vì mỗi kho lưu trữ PCP được tạo thành từ
một số tập tin vật lý.

Trong khi pmlogrewrite có thể được sử dụng để sửa chữa một số vấn đề về tính nhất quán của dữ liệu trong kho lưu trữ PCP,
Ngoài ra còn có một loại nhiệm vụ sửa chữa mà không thể xử lý được pmlogrewrite và
pmloglabel(1) có thể là một công cụ hữu ích trong những trường hợp này.

COMMAND ĐƯỜNG DÂY LỰA CHỌN

Các tùy chọn dòng lệnh cho pmlogrewrite như sau:

-C Phân tích các quy tắc viết lại và thoát. đăng xuất không được tạo ra. Khi -C được quy định,
cái này cũng đặt -v và -w để tất cả các cảnh báo và thông báo dài dòng được hiển thị dưới dạng
cấu hình được phân tích cú pháp.

-c cấu hình
If cấu hình là một tập tin hoặc liên kết tượng trưng, ​​​​đọc và phân tích các quy tắc viết lại từ đó.
If cấu hình là một thư mục thì tất cả các tập tin hoặc liên kết tượng trưng trong thư mục đó
(không bao gồm những từ bắt đầu bằng dấu chấm ``.'') sẽ được sử dụng để cung cấp
viết lại quy tắc. Nhiều -c các tùy chọn được cho phép.

-d Chế độ tuyệt vọng. Thông thường, nếu một lỗi nghiêm trọng xảy ra, tất cả các dấu vết của một phần
văn bản lưu trữ PCP đăng xuất bị xóa. Với -d tùy chọn, được tạo một phần
đăng xuất nhật ký lưu trữ không bị xóa.

-i Thay vì tạo đăng xuất, đăng nhập được viết lại tại chỗ khi -i Tùy chọn là
đã sử dụng. Một kho lưu trữ mới được tạo bằng tên tệp tạm thời và sau đó được đổi tên thành
đăng nhập theo cách mà nếu gặp phải bất kỳ lỗi nào (không phải cảnh báo), đăng nhập
vẫn không thay đổi.

-q Chế độ nhanh, trong đó nếu không có hành động viết lại nào được thực hiện (không có hành động nào
dữ liệu toàn cầu, tên miền phiên bản hoặc số liệu từ đăng nhập sẽ được thay đổi), sau đó
pmlogrewrite sẽ thoát (với trạng thái 0, nghĩa là thành công) ngay sau khi phân tích cú pháp
(các) tập tin cấu hình và đăng xuất không được tạo.

-s Khi "đơn vị" của một số liệu được thay đổi, nếu thứ nguyên về mặt không gian,
thời gian và số lượng không thay đổi, thì hệ số tỷ lệ đang được thay đổi, ví dụ BYTE thành
KBYTE hoặc MSEC-1 đến USEC-1 hoặc MBYTE.SEC-1 tổng hợp đến KBYTE.USEC-1. Các
động cơ có thể là (a) siêu dữ liệu ban đầu sai nhưng các giá trị trong đăng nhập
là chính xác hoặc (b) siêu dữ liệu đang thay đổi nên các giá trị cũng cần thay đổi.
Mặc định pmlogrewrite hành vi phù hợp với trường hợp (a). Nếu trường hợp (b) áp dụng thì sử dụng
các -s tùy chọn và giá trị của tất cả các số liệu với hệ số tỷ lệ thay đổi trong mỗi
kết quả sẽ được thay đổi kích thước. Để kiểm soát tốt hơn việc thay đổi tỷ lệ giá trị, hãy tham khảo
CHỈNH LẠI tùy chọn cho CÁC ĐƠN VỊ mệnh đề của quy tắc viết lại số liệu được mô tả dưới đây.

-v Tăng tính chi tiết của đầu ra chẩn đoán.

-w Phát ra cảnh báo. Thông thường pmlogrewrite giữ im lặng trước bất kỳ cảnh báo nào không phải
gây tử vong và người ta mong đợi rằng đối với một kho lưu trữ cụ thể, một số (hoặc thực sự là tất cả)
các thông số kỹ thuật viết lại có thể không được áp dụng. Ví dụ: những thay đổi đối với PMDA có thể
được ghi lại trong một tập hợp các quy tắc viết lại, nhưng một kho lưu trữ có thể không chứa tất cả
các số liệu được sửa đổi cũng như tất cả các miền và/hoặc phiên bản đã sửa đổi.
Vì những trường hợp này được dự đoán trước nên chúng không ngăn cản được pmlogrewrite thực thi và
quy định không áp dụng cho đăng nhập được âm thầm bỏ qua theo mặc định. Tương tự, một số
quy tắc viết lại có thể không có thay đổi gì vì siêu dữ liệu trong đăng nhập đã khớp rồi
mục đích của quy tắc viết lại để sửa dữ liệu từ phiên bản trước của PMDA.
-w flag buộc phải đưa ra cảnh báo cho tất cả các trường hợp này.

Đối số đăng xuất là bắt buộc trong mọi trường hợp, trừ khi -i được quy định.

VIẾT LẠI QUY TẮC TỔNG HỢP

Tệp cấu hình không chứa hoặc nhiều quy tắc viết lại như được xác định bên dưới.

Từ khóa và ký tự dấu câu đặc biệt được hiển thị bên dưới trong in đậm phông chữ và là
không phân biệt chữ hoa chữ thường, vì vậy HỆ MÉT, số liệu và metric đều tương đương trong quy tắc viết lại.

Ký tự ``#'' giới thiệu một nhận xét và phần còn lại của dòng bị bỏ qua.
Mặt khác, đầu vào có định dạng tương đối tự do với khoảng trắng tùy chọn (dấu cách, tab hoặc
dòng mới) giữa các mục từ vựng trong quy tắc.

A toàn cầu quy tắc viết lại có dạng:

GLOBAL { thông số toàn cầu ... }

Ở đâu thông số toàn cầu bằng 0 hoặc nhiều hơn trong các mệnh đề sau:

TÊN MÁY CHỦ -> hostname

Sửa đổi các bản ghi nhãn trong đăng xuất Lưu trữ PCP để các số liệu sẽ
dường như đã được thu thập từ máy chủ hostname.

THỜI GIAN -> đồng bằng

Cả giá trị số liệu và siêu dữ liệu miền phiên bản trong kho lưu trữ PCP đều mang
dấu thời gian. Điều khoản này buộc tất cả các dấu thời gian phải được điều chỉnh bởi đồng bằng, Nơi
đồng bằng là một dấu hiệu tùy chọn ``+'' (mặc định) hoặc ``-'', một số tùy chọn của
giờ theo sau là dấu hai chấm ``:'', số phút tùy chọn theo sau là dấu hai chấm
``:'', một số giây, một phần giây tùy chọn sau một dấu chấm
``.''. Ví dụ đơn giản nhất là ``30'' để tăng dấu thời gian lên 30
giây. Một ví dụ phức tạp hơn sẽ là ``-23:59:59.999'' để di chuyển dấu thời gian
lùi lại một mili giây ít hơn một ngày.

TZ -> "Múi giờ"

Sửa đổi các bản ghi nhãn trong đăng xuất Lưu trữ PCP để các số liệu sẽ
dường như đã được thu thập từ một máy chủ có múi giờ địa phương là Múi giờ.
Múi giờ phải được đặt trong dấu ngoặc kép và phải tuân theo múi giờ hợp lệ
quy tắc cú pháp cho nền tảng cục bộ.

An thống trị quy tắc viết lại sửa đổi một miền thể hiện và có dạng:

INDOM miền.nối tiếp { indomspec ... }

Ở đâu miền và nối tiếp xác định một hoặc nhiều miền phiên bản hiện có từ đăng nhập -
thường miền sẽ là một số nguyên trong phạm vi từ 1 đến 510 và nối tiếp sẽ là một số nguyên
trong phạm vi từ 0 đến 4194304.

Như một trường hợp đặc biệt nối tiếp có thể là dấu hoa thị ``*'' có nghĩa là quy tắc áp dụng cho mọi
tên miền ví dụ có số tên miền là miền.

Nếu một miền phiên bản được chỉ định không có trong đăng nhập quy tắc này không có hiệu lực.

indomspec bằng 0 hoặc nhiều hơn trong các mệnh đề sau:

INAME "tên Cu" -> "tên mới"

Phiên bản được xác định bởi tên phiên bản bên ngoài tên Cu được đổi tên thành
tên mới. Cả hai tên Cu và tên mới phải được đặt trong dấu ngoặc kép.

Trường hợp đặc biệt, tên mới có thể là từ khóa DELETE (không có dấu ngoặc kép) và
sau đó là ví dụ tên Cu sẽ bị xóa khỏi đăng xuất cái này loại bỏ nó khỏi
siêu dữ liệu miền của phiên bản và xóa tất cả các giá trị của phiên bản này cho tất cả
các số liệu liên quan.

Nếu tên phiên bản chứa bất kỳ khoảng trắng nào thì cần phải đặc biệt cẩn thận.
được thực hiện theo quy tắc đặt tên phiên bản PCP xử lý ký tự không phải khoảng trắng hàng đầu
một phần của tên dụ là phần duy nhất của tên nhằm mục đích
khớp và đảm bảo tính duy nhất trong một miền ví dụ, hãy tham khảo
pmdaInstance(3) để thảo luận về vấn đề này.

Để minh họa, hãy xem xét miền ví dụ giả định cho một số liệu
chứa 2 trường hợp có tên sau:
đỏ
ừm, ừm

Sau đó một số có thể INAME mệnh đề có thể là:

“eek” -> “vàng như hoa”
Có thể chấp nhận được, tên Cu "eek" khớp với phiên bản "eek urk".

"đỏ" -> "eek"
Lỗi, tên mới "eek" khớp với phiên bản "eek urk" hiện có.

"eek urk" -> "màu đỏ của sắc khác"
Lỗi, tên mới "màu đỏ của màu khác" khớp với phiên bản "màu đỏ" hiện có.

INDOM -> tên miền mới.mới

Sửa đổi siêu dữ liệu cho miền phiên bản và mọi số liệu được liên kết với
miền ví dụ. Là trường hợp đặc biệt, mới có thể là dấu hoa thị ``*'' mà
nghĩa là sử dụng nối tiếp từ thống trị quy tắc viết lại, mặc dù điều này hữu ích nhất khi
nối tiếp cũng là một dấu hoa thị. Ví dụ:
indom 29.* { indom -> 109.* }
sẽ chuyển tất cả các miền phiên bản từ miền 29 sang miền 109.

INDOM -> BẢN SAO tên miền mới.mới

Trường hợp đặc biệt trước đó INDOM mệnh đề trong đó miền ví dụ là một
bản sao trùng lặp của miền.nối tiếp tên miền ví dụ từ thống trị quy tắc viết lại
và sau đó mọi quy tắc ánh xạ sẽ được áp dụng cho bản sao chép tên miền mới.mới ví dụ
lãnh địa. Điều này rất hữu ích khi một PMDA được tách ra và cùng một miền phiên bản cần phải
được nhân rộng cho tên miền miền và miền tên miền mới. Vì vậy, ví dụ nếu
số liệu foo.one và foo.two cả hai đều được xác định trên miền phiên bản 12.34 và
foo.two được chuyển sang PMDA khác bằng miền 27, sau đó viết lại
có thể sử dụng các quy tắc:
indom 12.34 { indom -> trùng lặp 27.34 }
số liệu foo.two { indom -> 27.34 chiều -> 27.*.* }

CÀI ĐẶT người già -> người mới

Phiên bản được xác định bởi mã định danh phiên bản nội bộ người già được đánh số lại thành
người mới. Cả hai người già và người mới là các số nguyên trong khoảng từ 0 đến 231-1.

Như một trường hợp đặc biệt, người mới có thể là từ khóa DELETE và sau đó là ví dụ người già
sẽ bị xóa khỏi đăng xuất loại bỏ nó khỏi siêu dữ liệu tên miền ví dụ
và xóa tất cả các giá trị của phiên bản này đối với tất cả các số liệu liên quan.

A số liệu quy tắc viết lại có dạng:

HỆ MÉT số liệu { thông số kỹ thuật ... }

Ở đâu số liệu xác định một hoặc nhiều số liệu hiện có từ đăng nhập sử dụng một thước đo
tên hoặc mã hóa nội bộ cho PMID của số liệu dưới dạng miền.cụm.mục. Trong phần sau
trường hợp, thông thường miền sẽ là một số nguyên trong phạm vi từ 1 đến 510, cụm sẽ là một
số nguyên trong phạm vi từ 0 đến 4095 và mục sẽ là một số nguyên trong khoảng từ 0 đến 1023.

Là trường hợp đặc biệt mục có thể là dấu hoa thị ``*'' có nghĩa là quy tắc áp dụng cho mọi
số liệu có số miền là miền và số cụm của cụm, hoặc là cụm có thể
dấu hoa thị có nghĩa là quy tắc áp dụng cho mọi số liệu có số miền là miền
và một số mặt hàng của mục, hoặc cả hai cụm và mục có thể là dấu hoa thị và quy tắc được áp dụng
tới mọi số liệu có số miền là miền.

Nếu số liệu được chỉ định không có trong đăng nhập quy tắc này không có hiệu lực.

thông số kỹ thuật bằng 0 hoặc nhiều hơn trong các mệnh đề sau:

DELETE

Chỉ số này bị xóa hoàn toàn khỏi đăng xuất, cả siêu dữ liệu và tất cả các giá trị trong
kết quả được xóa bỏ

INDOM -> tên miền mới.mới [ chọn ]

Sửa đổi siêu dữ liệu để thay đổi miền phiên bản cho số liệu này. Cái mới
tên miền ví dụ phải tồn tại trong đăng xuất.

Tùy chọn chọn mệnh đề có thể được sử dụng để chọn một giá trị đầu vào hoặc tính toán một giá trị
giá trị tổng hợp từ các phiên bản trong kết quả đầu vào hoặc gán giá trị nội bộ
mã định danh cá thể thành một giá trị đầu ra duy nhất. Nếu không chọn điều khoản được quy định,
hành vi mặc định là sao chép tất cả các giá trị đầu vào từ mỗi kết quả đầu vào sang đầu ra
tuy nhiên, nếu miền thể hiện đầu vào là số ít (indom CH_INDOM_NULL)
thì một giá trị đầu ra phải được gán một mã định danh cá thể bên trong, giá trị này
theo mặc định là 0, trừ khi bị ghi đè bởi CÀI ĐẶT or INAME khoản như được định nghĩa dưới đây.

Các lựa chọn cho chọn như sau:

OUTPUT ĐẦU TIÊN
chọn giá trị của phiên bản đầu tiên từ mỗi kết quả đầu vào

OUTPUT LAST chọn giá trị của phiên bản cuối cùng từ mỗi kết quả đầu vào

OUTPUT CÀI ĐẶT nhắc nhở
chọn giá trị của thể hiện với mã định danh thể hiện nội bộ
nhắc nhở từ mỗi kết quả; trình tự các quy tắc viết lại đảm bảo
OUTPUT quá trình xử lý diễn ra trước khi đánh số lại mã định danh cá thể từ
bất kỳ liên quan thống trị quy tắc, vì vậy nhắc nhở nên là một trong những nội bộ
số nhận dạng cá thể xuất hiện trong đăng nhập

OUTPUT INAME "tên"
chọn giá trị của thể hiện với tên cho ví dụ bên ngoài của nó
tên từ mỗi kết quả; trình tự các quy tắc viết lại đảm bảo
OUTPUT quá trình xử lý diễn ra trước khi đổi tên phiên bản từ bất kỳ phiên bản nào được liên kết
thống trị quy tắc, vì vậy tên phải là một trong những tên phiên bản bên ngoài
xuất hiện trong đăng nhập

OUTPUT MIN chọn giá trị nhỏ nhất trong mỗi kết quả (loại số liệu phải là số
và phiên bản đầu ra sẽ là 0 đối với miền phiên bản không phải là số ít)

OUTPUT MAX chọn giá trị lớn nhất trong mỗi kết quả (loại số liệu phải là số
và phiên bản đầu ra sẽ là 0 đối với miền phiên bản không phải là số ít)

OUTPUT TÓM TẮT chọn tổng của tất cả các giá trị trong mỗi kết quả (loại số liệu phải là
phiên bản số và đầu ra sẽ là 0 đối với phiên bản không phải là số ít
miền)

OUTPUT AVG chọn mức trung bình của tất cả các giá trị trong mỗi kết quả (loại số liệu phải là
phiên bản số và đầu ra sẽ là 0 đối với phiên bản không phải là số ít
miền)

Nếu miền thể hiện đầu vào là số ít (indom CH_INDOM_NULL) thì độc lập với
bất kì chọn thông số kỹ thuật, có nhiều nhất một giá trị trong mỗi kết quả đầu vào và do đó
ĐẦU TIÊN, LAST, MIN, MAX, TÓM TẮT và AVG tất cả đều tương đương và phiên bản đầu ra
định danh sẽ là 0.

Nói chung, đó là một lỗi khi chỉ định hành động viết lại cho cùng một siêu dữ liệu hoặc
giá trị kết quả nhiều lần, ví dụ như nhiều hơn một INDOM điều khoản tương tự
miền ví dụ. Ngoại lệ duy nhất là khả năng tương tác giữa INDOM
các khoản trong thống trị và số liệu quy tắc. Ví dụ như thước đo mẫu.bin is
được xác định trên miền cá thể 29.2 trong đăng nhập và những điều sau đây có thể chấp nhận được
(mặc dù thừa):
indom 29.* { indom -> 109.* }
mẫu số liệu.bin { indom -> 109.2 }
Tuy nhiên, đây là một lỗi, vì miền ví dụ cho mẫu.bin có
hai định nghĩa trái ngược nhau:
indom 29.* { indom -> 109.* }
mẫu số liệu.bin { indom -> 123.2 }

INDOM -> NULL[ chọn ]

Số liệu (phải được xác định trước đó trên một miền mẫu) là
đang được sửa đổi thành một số liệu số ít. Điều này liên quan đến việc thay đổi siêu dữ liệu và
thu gọn tất cả kết quả cho số liệu này để nhiều giá trị trở thành một giá trị.

Tùy chọn chọn một phần của mệnh đề xác định cách một giá trị cho mỗi kết quả
phải được tính toán và tuân theo các quy tắc tương tự như được mô tả cho giá trị không NULL
INDOM trường hợp trên.

Trong trường hợp không có chọn, mặc định là OUTPUT ĐẦU TIÊN.

TÊN -> tên mới

Đổi tên số liệu trong siêu dữ liệu của kho lưu trữ PCP hỗ trợ Hiệu suất
Không gian tên số liệu (PMNS). tên mới không được khớp với bất kỳ tên hiện có nào trong
PMNS của kho lưu trữ và phải tuân theo các quy tắc cú pháp đối với tên số liệu hợp lệ như
nêu trong chiều(5).

PMID -> tên miền mới.cụm mới.vật phẩm mới

Sửa đổi siêu dữ liệu và kết quả để đánh số lại PMID của số liệu. Đặc biệt
các trường hợp, cụm mới có thể là dấu hoa thị ``*'' có nghĩa là sử dụng cụm từ
số liệu quy tắc viết lại và/hoặc mục có thể là dấu hoa thị có nghĩa là sử dụng mục từ
các số liệu quy tắc viết lại. Điều này hữu ích nhất khi cụm và / hoặc mục cũng là
một dấu hoa thị. Ví dụ:
số liệu 30.*.* { pmid -> 123.*.* }
sẽ chuyển tất cả số liệu từ miền 30 sang miền 123.

SEM -> bản tin

Thay đổi ngữ nghĩa của số liệu. bản tin phải là phần XXX của tên
một trong những PM_SEM_XXX macro được xác định trong hoặc chiềuTra cứuDesc(3), ví dụ
COUNTER cho PM_TYPE_COUNTER.

Không có việc ghi lại giá trị dữ liệu nào được thực hiện do SEM điều khoản, vì vậy
tính hữu dụng bị giới hạn trong trường hợp phiên bản của PMDA liên quan được
xuất khẩu ngữ nghĩa không chính xác cho số liệu. pmlogreduce(1) có thể cung cấp một
thay thế trong trường hợp cần tính toán lại các giá trị kết quả.

LOẠI -> kiểu mới

Thay đổi loại số liệu làm thay đổi siêu dữ liệu và có thể thay đổi
mã hóa các giá trị trong kết quả. kiểu mới phải là phần XXX trong tên của một người
của CH_TYPE_XXX macro được xác định trong hoặc chiềuTra cứuDesc(3), ví dụ PHAO NỔI
cho PM_TYPE_FLOAT.

Chuyển đổi loại chỉ được hỗ trợ trong trường hợp loại chỉ số cũ và mới
số, vì vậy CH_TYPE_STRING, PM_TYPE_AGGREGATE và PM_TYPE_EVENT không được cho phép.
Ngay cả đối với các trường hợp số, một số chuyển đổi có thể tạo ra lỗi trong thời gian chạy, ví dụ:
tràn số nguyên hoặc cố gắng viết lại một giá trị âm thành kiểu không dấu.

CÁC ĐƠN VỊ -> đơn vị mới [ CHỈNH LẠI ]

đơn vị mới là sáu giá trị cách nhau bằng dấu phẩy. 3 giá trị đầu tiên mô tả
chiều của thước đo dọc theo chiều không gian, thời gian và số đếm; đó là
giá trị nguyên, thường là 0, 1 hoặc -1. 3 giá trị còn lại mô tả thang đo của
các giá trị của số liệu theo các chiều không gian, thời gian và số lượng. Quy mô không gian
giá trị phải là 0 (nếu kích thước không gian là 0), nếu không thì phần XXX của tên
một trong những CH_SPACE_XXX macro, ví dụ KBYTE cho PM_TYPE_KBYTE. Giá trị thang thời gian
phải là 0 (nếu chiều thời gian là 0), nếu không thì phần XXX của tên của một trong các
các Chiều_TIME_XXX macro, ví dụ SEC cho chiều_TIME_SEC. Giá trị tỷ lệ đếm phải bằng 0
(nếu chiều thời gian là 0), ngược lại ONE cho PM_COUNT_ONE.

CH_SPACE_XXX, Chiều_TIME_XXX và PM_COUNT_XXX macro được xác định trong
or chiềuTra cứuDesc(3).

Khi tỷ lệ được thay đổi (nhưng kích thước không thay đổi) từ khóa tùy chọn
CHỈNH LẠI có thể được sử dụng để chọn thay đổi tỷ lệ giá trị theo -s tùy chọn dòng lệnh,
nhưng chỉ áp dụng cho số liệu này.

Khi thay đổi số miền cho một miền số liệu hoặc miền phiên bản, số miền mới
thường sẽ khớp với số miền của PMDA hiện có. Nếu đây không phải là trường hợp thì
số miền mới không nên được chọn ngẫu nhiên; tham khảo ý kiến $PCP_VAR_DIR/pmns/stdpmid
đối với số miền đã được gán cho PMDA.

VÍ DỤ

Để nâng cấp các giá trị của số liệu IOPS trên mỗi đĩa lên 64-bit nhằm cho phép tổng hợp qua một
khoảng thời gian dài để lập kế hoạch công suất hoặc do PMDA đã thay đổi sang xuất khẩu 64-bit
bộ đếm và chúng tôi muốn chuyển đổi các kho lưu trữ cũ để chúng có thể được xử lý cùng với các kho lưu trữ mới
tài liệu lưu trữ.
đĩa số liệu.dev.read { loại -> U64 }
đĩa số liệu.dev.write { loại -> U64 }
đĩa số liệu.dev.total { loại -> U64 }

Các trường hợp được liên kết với chỉ số tải trung bình kernel.all.load có thể được đổi tên và
được đánh số lại theo quy tắc dưới đây.
# đối với PMDA Linux, số liệu kernel.all.load được xác định
# trên miền phiên bản 60.2
indom 60.2 {
inst 1 -> 60 inname "1 phút" -> "60 giây"
inst 5 -> 300 inname "5 phút" -> "300 giây"
inst 15 -> 900 inname "15 phút" -> "900 giây"
}

Nếu chúng tôi quyết định tách các số liệu ``proc'' ra khỏi PMDA Linux, điều này sẽ liên quan đến
thay đổi số miền cho PMID của các số liệu này và phiên bản được liên kết
tên miền. Các quy tắc bên dưới sẽ viết lại kho lưu trữ cũ để phù hợp với những thay đổi sau PMDA
chia nhỏ.
# tất cả số liệu quy trình Linux đều nằm trong 7 cụm
số liệu 60.8.* { pmid -> 123.*.* }
số liệu 60.9.* { pmid -> 123.*.* }
số liệu 60.13.* { pmid -> 123.*.* }
số liệu 60.24.* { pmid -> 123.*.* }
số liệu 60.31.* { pmid -> 123.*.* }
số liệu 60.32.* { pmid -> 123.*.* }
số liệu 60.51.* { pmid -> 123.*.* }
# chỉ một miền phiên bản cho các số liệu quy trình Linux
indom 60.9 { indom -> 123.0 }

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