命令选项

--service-name <NAME> | --sn <NAME>

服务的名称。

--region <NAME> | -r <NAME>

地区名称，例如 us-south 或 eu-gb。 如果未指定，那么将使用已登录或目标区域。

--all-regions

跨所有区域托管的服务。

-g <GROUP>

与托管服务关联的资源组。

--all-resource-groups

在所有资源组中托管的服务。

--quiet | -q

Su按详细输出。

--output <TYPE>

用双引号 (") 括起的输出首选项的逗号分隔列表。如果仅指定了单个首选项，那么可以省略双引号。 受支持的选项包括 WIDE 和 JSON。

如果指定了 JSON，那么将以 JSON 格式返回输出。 如果未指定 JSON，输出将以表格格式返回。

WIDE 在输出中返回其他详细信息。

--help | -h

列出可用于该命令的选项。

示例

以下是使用 ibmcloud logging service-instances 命令的示例。

列出所有日志服务实例。

ibmcloud logging service-instances

列出 test-rg 资源组中的所有实例。

ibmcloud logging service-instances -g test-rg

列出所有实例并包含其他详细信息，例如标识，GUID 和资源标识。

ibmcloud logging service-instances --output wide

列出所有实例，并且仅包含“名称”，“区域”和“省/直辖市/自治区”的最小详细信息。

ibmcloud logging service-instances --quiet

列出 us-south 区域的所有实例。

ibmcloud logging service-instances --region us-south

列出 us-south 区域中的所有实例，并以 JSON 格式返回输出。

ibmcloud logging service-instances --region us-south --output json

命令选项

--service-key <SERVICE_KEY> | -s <SERVICE_KEY>

(REQUIRED) 实例的服务密钥。

--region <REGION> | -r <REGION>

地区名称，例如 us-south 或 eu-gb。 如果未指定，那么将使用已登录或目标区域。

--hosts <HOST_NAMES> | --ho <HOST_NAMES>

用双引号 (") 括起的主机名的逗号分隔列表。如果仅指定单个主机名，那么可以省略双引号。 将返回指定主机名的日志条目。

--apps <APP_NAMES> | -a <APP_NAMES>

用双引号 (") 括起的应用程序名称的逗号分隔列表。如果仅指定单个应用程序名称，那么可以省略双引号。 将返回指定应用程序的日志条目。

--levels <LOG_LEVELS> | -l <LOG_LEVELS>

用双引号 (") 括起的日志级别值的逗号分隔列表。如果仅指定了单个级别，那么可以省略双引号。 将返回具有指定级别的日志条目。 根据您的环境日志级别，可以包括 :CRITICAL，DEBUG，CRITICAL，ERROR，FATAL，INFO，SEVERE，TRACE，WARN 或 ALERT。

--number <NUMBER> | -n <NUMBER>

要导出的日志条目总数。

--from <TIME>

要用于日志条目的开始时间。 不会返回早于此时间的日志条目。<TIME> 指定为 UNIX 时间戳记 (以秒或毫秒计)。

--to <TIME>

要用于日志条目的结束时间。 在此时间之后将不会返回任何日志条目。<TIME> 指定为 UNIX 时间戳记 (以秒或毫秒计)。

--output <TYPE>

生成的输出的类型。 如果指定了 JSON，那么将以 JSON 格式返回输出。 如果未指定，输出将以表格格式返回。

--query <STRING> | -q <STRING>

要在日志中搜索的值。 将返回所有包含指定 <STRING> 的日志条目。

--prefer <VALUE> | -p <VALUE>

要导出的日志行。 有效值为 HEAD 和 TAIL。HEAD 指定将从最早的条目导出到最新条目的日志行。TAIL 指定将以从最新条目到最早条目的反向顺序导出日志行。 如果未指定，默认值为 TAIL。

--email <ADDRESS> | -e <ADDRESS>

如果指定此项，那么将向指定的电子邮件 <ADDRESS> 发送包含导出信息的链接的电子邮件。 收件人可以使用该链接来下载导出的信息。

--email-subject <SUBJECT> | --es <SUBJECT>

与 --email 配合使用以指定要包含在发送的电子邮件中的主题行。

--help | -h

列出可用于该命令的选项。

示例

以下是使用 ibmcloud logging export 命令的示例。

导出所提供服务密钥的所有日志。

ibmcloud logging export --service-key <SERVICE_KEY>

导出在指定时间范围内发生的所提供服务密钥的日志条目。 时间戳记需要采用 UNIX 格式。 例如：1614228407550。

ibmcloud logging export --service-key <SERVICE_KEY> --to <END_TIME> --from <START_TIME>

导出所提供服务密钥的 INFO 和 ERROR 级别日志条目。

ibmcloud logging export --service-key <SERVICE_KEY> --levels "INFO,ERROR"

导出所提供服务密钥的 metric-server 和 myapp 应用程序的日志条目。

ibmcloud logging export --service-key <SERVICE_KEY> --apps "metrics-server,myapp"

导出所提供服务密钥的 test-hostname 和 cloudantnosqldb 主机的日志条目。

ibmcloud logging export --service-key <SERVICE_KEY> --hosts "test-hostname,cloudantnosqldb"

导出所提供服务密钥的 eu-gb 区域的日志条目。

ibmcloud logging export --service-key <SERVICE_KEY> --region eu-gb

导出包含所提供服务密钥的字符串 "new line" 的日志条目。

ibmcloud logging export --service-key <SERVICE_KEY> --query "new line"

导出包含所提供服务密钥的第一个日志行 (head) 中的字符串 "new line" 的日志条目。

ibmcloud logging export --service-key <SERVICE_KEY> --query "new line" --prefer head

导出所提供服务密钥的 myapp 应用程序的 JSON 格式日志条目。

ibmcloud logging export --service-key <SERVICE_KEY> --apps myapp --output json

使用主题为 "EMail myapp logs" 的可下载链接向 myemail@mycompany.com 发送电子邮件。 在此示例中，该链接将让 myemail@mycompany.com 在运行命令时查看所提供服务密钥的 myapp 应用程序的所有日志条目的列表。

ibmcloud logging export --service-key <SERVICE_KEY> --apps myapp --email myemail@mycompany.com --email-subject "Emailing myapp logs"