'\" t
.nh
.TH podman-events 1
.SH "نام (NAME)"
podman-events \- نظارت بر رویدادهای پودمن

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman events\fP [\fIoptions\fP]

.PP
\fBpodman system events\fP [\fIoptions\fP]

.SH "توضیحات (DESCRIPTION)"
نظارت و چاپ رویدادهایی که در پودمن رخ می‌دهند\&. هر رویداد شامل یک برچسب زمانی (timestamp)، یک نوع، یک وضعیت، نام (در صورت وجود) و ایمیج (در صورت وجود) است\&. سازوکار پیش‌فرض ثبت گزارش \fIjournald\fP است\&. این مقدار را می‌توان در containers.conf با تغییر مقدار \fBevents_logger\fR به \fBfile\fR تغییر داد\&. تنها مقادیر \fBfile\fR و \fBjournald\fR پذیرفته می‌شوند\&. یک ثبت‌کننده \fBnone\fR نیز در دسترس است، اما این سازوکار ثبت گزارش رویدادها را به‌طور کامل غیرفعال می‌کند؛ هیچ چیزی توسط \fBpodman events\fR گزارش نمی‌شود\&.

.PP
به‌طور پیش‌فرض از حالت جاری (streaming) استفاده می‌شود که رویدادهای جدید را هم‌زمان با وقوع آن‌ها چاپ می‌کند\&. رویدادهای قبلی را می‌توان از طریق \fB--since\fR و \fB--until\fR فهرست کرد\&.

.PP
نوع رویداد \fIcontainer\fP وضعیت‌های زیر را گزارش می‌دهد:
 * attach
 * checkpoint
 * cleanup
 * commit
 * connect
 * create
 * died
 * disconnect
 * exec
 * exec_died
 * exited
 * export
 * import
 * init
 * kill
 * mount
 * pause
 * prune
 * remove
 * rename
 * restart
 * restore
 * start
 * stop
 * sync
 * unmount
 * unpause
 * update

.PP
نوع رویداد \fIpod\fP وضعیت‌های زیر را گزارش می‌دهد:
 * create
 * kill
 * pause
 * remove
 * start
 * stop
 * unpause

.PP
نوع رویداد \fIimage\fP وضعیت‌های زیر را گزارش می‌دهد:
 * loadFromArchive,
 * mount
 * pull
 * pull-error
 * push
 * remove
 * save
 * tag
 * unmount
 * untag

.PP
نوع رویداد \fIartifact\fP وضعیت‌های زیر را گزارش می‌دهد:
 * create
 * pull
 * push
 * remove

.PP
نوع \fIsystem\fP وضعیت‌های زیر را گزارش می‌دهد:
 * refresh
 * renumber

.PP
نوع \fIvolume\fP وضعیت‌های زیر را گزارش می‌دهد:
 * create
 * prune
 * remove

.PP
نوع \fIsecret\fP وضعیت‌های زیر را گزارش می‌دهد:
 * create
 * remove

.PP
نوع \fInetwork\fP وضعیت‌های زیر را گزارش می‌دهد:
 * create
 * connect
 * disconnect
 * remove

.SS "رویدادهای تفصیلی ایجاد (Verbose Create Events)"
تنظیم \fBevents_container_create_inspect_data=true\fR در containers.conf(5) به پودمن دستور می‌دهد رویدادهای ایجاد کانتینر مفصل‌تری تولید کند که شامل یک بار داده (payload) در قالب JSON با اطلاعات دقیق درباره کانتینرها است\&. بار داده JSON با خروجی podman-container-inspect(1) یکسان است\&. فیلد مرتبط در journald به نام \fBPODMAN_CONTAINER_INSPECT_DATA\fR نام‌گذاری شده است\&.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP
فیلتر کردن رویدادهایی که نمایش داده می‌شوند\&. آن‌ها باید در قالب "filter=value" باشند\&. فیلترهای زیر پشتیبانی می‌شوند:

.TS
allbox;
l l 
l l .
\fB\fBفیلتر\fP\fP	\fB\fBتوضیحات\fP\fP
artifact	T{
[نام یا شناسه] نام یا شناسه دست‌سازه
T}
container	T{
[نام یا شناسه] نام یا شناسه کانتینر
T}
event	وضعیت رویداد (event_status که در بالا شرح داده شد)
image	[نام یا شناسه] نام یا شناسه ایمیج
label	برچسب به صورت [کلید] یا [کلید=مقدار]
pod	[نام یا شناسه] نام یا شناسه پاد
volume	[نام یا شناسه] نام یا شناسه حجم
type	نوع رویداد (event_type که در بالا شرح داده شد)
.TE

.PP
در مواردی که از شناسه استفاده می‌شود، شناسه می‌تواند به شکل کامل یا کوتاه‌شده باشد\&. رویداد "die" برای سازگاری با داکر به "died" نگاشت می‌شود\&.

.SS \fB--format\fP
قالب‌بندی خروجی به صورت JSON Lines یا با استفاده از قالب Go ارائه‌شده\&.

.TS
allbox;
l l 
l l .
\fB\fBجای‌نگه‌دار\fP\fP	\fB\fBتوضیحات\fP\fP
\&.Attributes ...	T{
created_at، _by، labels و موارد دیگر (map[])
T}
\&.ContainerExitCode	کد خروج (int)
\&.ContainerInspectData	T{
داده‌های inspect کانتینر
T}
\&.Error	T{
پیام خطا در صورتی که وضعیت رویداد خطا باشد (مانند pull-error)
T}
\&.HealthStatus	وضعیت سلامت (string)
\&.ID	شناسه کانتینر (SHA کامل ۶۴ بیتی)
\&.Image	T{
نام ایمیج در حال اجرا (string)
T}
\&.Name	نام کانتینر (string)
\&.Network	T{
نام شبکه مورد استفاده (string)
T}
\&.OOMKilled	T{
آیا کانتینر به دلیل کمبود حافظه (OOM) متوقف شده است (bool)
T}
\&.PodID	T{
شناسه پاد مرتبط با کانتینر، در صورت وجود
T}
\&.Status	T{
وضعیت رویداد (مانند create، start، died، ...)
T}
\&.Time	برچسب زمانی رویداد (string)
\&.TimeNano	T{
برچسب زمانی رویداد با دقت نانوثانیه (int64)
T}
\&.Type	T{
نوع رویداد (مانند image، container، pod، ...)
T}
.TE

.SS \fB--help\fP
چاپ راهنمای استفاده\&.

.SS \fB--no-trunc\fP
کوتاه نکردن خروجی (پیش‌فرض \fItrue\fP)\&.

.SS \fB--since\fP=\fItimestamp\fP
نمایش تمام رویدادهای ایجادشده پس از برچسب زمانی داده‌شده\&.

.SS \fB--stream\fP
پخش جریانی رویدادها و خارج نشدن پس از خواندن آخرین رویداد شناخته‌شده (پیش‌فرض \fItrue\fP)\&.

.SS \fB--until\fP=\fItimestamp\fP
نمایش تمام رویدادهای ایجادشده تا برچسب زمانی داده‌شده\&.

.PP
مقادیر \fIsince\fP و \fIuntil\fP می‌توانند برچسب‌های زمانی RFC3339Nano یا یک رشته مدت زمان Go مانند 10m یا 5h باشند\&. اگر هیچ مقداری برای \fIsince\fP یا \fIuntil\fP ارائه نشود، تنها رویدادهای جدید نمایش داده می‌شوند\&.

.SH "شناسه‌های JOURNALD (JOURNALD IDENTIFIERS)"
بک‌اند رویدادهای journald در پودمن از شناسه‌های journald زیر استفاده می‌کند\&. می‌توانید از این شناسه‌ها برای فیلتر کردن مستقیم رویدادهای پودمن با استفاده از \fBjournalctl\fR استفاده کنید\&.

.TS
allbox;
l l 
l l .
\fB\fBشناسه\fP\fP	\fB\fBتوضیحات\fP\fP
SYSLOG_IDENTIFIER	همیشه روی "podman" تنظیم می‌شود
PODMAN_EVENT	T{
وضعیت رویداد همان‌طور که در بالا توضیح داده شد
T}
PODMAN_TYPE	T{
نوع رویداد همان‌طور که در بالا توضیح داده شد
T}
PODMAN_TIME	T{
برچسب زمانی هنگام ثبت رویداد
T}
PODMAN_NAME	T{
نام شیء رویداد (مانند container، image، artifact)
T}
PODMAN_ID	T{
شناسه شیء رویداد (مانند container، image، artifact)
T}
PODMAN_EXIT_CODE	کد خروج کانتینر
PODMAN_POD_ID	شناسه پاد کانتینر
PODMAN_LABELS	برچسب‌های کانتینر
PODMAN_HEALTH_STATUS	وضعیت سلامت کانتینر
PODMAN_CONTAINER_INSPECT_DATA	بار داده JSON از \fBpodman-inspect\fR همان‌طور که در بالا توضیح داده شد
PODMAN_NETWORK_NAME	نام شبکه
.TE

.SH "مثال‌ها (EXAMPLES)"
نمایش رویدادهای پودمن:

.EX
$ podman events
2019-03-02 10:33:42.312377447 -0600 CST container create 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
2019-03-02 10:33:46.958768077 -0600 CST container init 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
2019-03-02 10:33:46.973661968 -0600 CST container start 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
2019-03-02 10:33:50.833761479 -0600 CST container stop 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
2019-03-02 10:33:51.047104966 -0600 CST container cleanup 34503c192940 (image=docker.io/library/alpine:latest, name=friendly_allen)
.EE

.PP
تنها نمایش رویدادهای ایجاد کانتینر در پودمن:

.EX
$ podman events -f event=create
2019-03-02 10:36:01.375685062 -0600 CST container create 20dc581f6fbf (image=docker.io/library/alpine:latest, name=sharp_morse)
2019-03-02 10:36:08.561188337 -0600 CST container create 58e7e002344c (image=registry.k8s.io/pause:3.1, name=3e701f270d54-infra)
2019-03-02 10:36:13.146899437 -0600 CST volume create cad6dc50e087 (image=, name=cad6dc50e0879568e7d656bd004bd343d6035e7fc4024e1711506fe2fd459e6f)
2019-03-02 10:36:29.978806894 -0600 CST container create d81e30f1310f (image=docker.io/library/busybox:latest, name=musing_newton)
.EE

.PP
تنها نمایش رویدادهای ایجاد پاد در پودمن:

.EX
$ podman events --filter event=create --filter type=pod
2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
2019-03-02 10:44:47.486759133 -0600 CST pod create 71e807fc3a8e (image=, name=reverent_swanson)
.EE

.PP
تنها نمایش رویدادهای پودمن که در پنج دقیقه گذشته ایجاد شده‌اند:

.EX
$ sudo podman events --since 5m
2019-03-02 10:44:29.598835409 -0600 CST container create b629d10d3831 (image=registry.k8s.io/pause:3.1, name=1df5ebca7b44-infra)
2019-03-02 10:44:29.601746633 -0600 CST pod create 1df5ebca7b44 (image=, name=confident_hawking)
2019-03-02 10:44:42.371100253 -0600 CST container create 170a0f457d00 (image=registry.k8s.io/pause:3.1, name=ca731231718e-infra)
2019-03-02 10:44:42.374637304 -0600 CST pod create ca731231718e (image=, name=webapp)
.EE

.PP
نمایش رویدادهای پودمن در قالب JSON Lines:

.EX
$ podman events --format json
{"ID":"683b0909d556a9c02fa8cd2b61c3531a965db42158627622d1a67b391964d519","Image":"localhost/myshdemo:latest","Name":"agitated_diffie","Status":"cleanup","Time":"2019-04-27T22:47:00.849932843-04:00","Type":"container"}
{"ID":"a0f8ab051bfd43f9c5141a8a2502139707e4b38d98ac0872e57c5315381e88ad","Image":"docker.io/library/alpine:latest","Name":"friendly_tereshkova","Status":"unmount","Time":"2019-04-28T13:43:38.063017276-04:00","Type":"container"}
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBcontainers.conf(5)\fP

.SH "تاریخچه (HISTORY)"
مارس ۲۰۱۹، در ابتدا توسط Brent Baude به نشانی bbaude@redhat.com گردآوری شد
\[la]mailto:bbaude@redhat.com\[ra]