Opções de comando

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

Nome do serviço.

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

Nome da região, por exemplo, us-south ou eu-gb. Se não for especificado, a região logada ou direcionada será usada.

--all-regions

Serviços hospedados em todas as regiões.

-g <GROUP>

Grupo de recursos associado ao serviço hospedado.

--all-resource-groups

Serviços hospedados em todos os grupos de recursos.

--quiet | -q

Elimina saída de verbose.

--output <TYPE>

Uma lista separada por vírgulas de preferências de saída entre aspas duplas ("). Se apenas uma única preferência for especificada, as aspas duplas podem ser omitidas. As opções suportadas são WIDE e JSON.

Se o JSON for especificado, a saída será devolvida no formato JSON. Se o JSON não for especificado, a saída será retornada em um formato tabular.

WIDE retorna detalhes adicionais na saída.

--help | -h

Liste as opções disponíveis para o comando.

Exemplos

O seguinte são exemplos usando o comando ibmcloud logging service-instances.

Lista todas as instâncias de serviço de criação de log.

ibmcloud logging service-instances

Listar todas as instâncias que estão no grupo de recursos test-rg.

ibmcloud logging service-instances -g test-rg

Liste todas as instâncias e inclua detalhes adicionais, como ID, GUID e ID de recurso.

ibmcloud logging service-instances --output wide

Liste todas as instâncias e inclua apenas os detalhes básicos de Nome, Região e Estado.

ibmcloud logging service-instances --quiet

Listar todas as instâncias para a região us-south.

ibmcloud logging service-instances --region us-south

Liste todas as instâncias na região us-south e retorna a saída em formato JSON.

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

Opções de comando

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

(OBRIGATÓRIO) Chave de serviço para a instância.

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

Nome da região, por exemplo, us-south ou eu-gb. Se não for especificado, a região logada ou direcionada será usada.

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

Uma lista separada por vírgulas de nomes de host entre aspas duplas ("). Se apenas um único nome de host for especificado, as aspas duplas podem ser omitidas. As entradas de log para os nomes de hosts especificados serão retornadas.

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

Uma lista separada por vírgulas de nomes de aplicativos entre aspas duplas ("). Se apenas um único nome de aplicativo for especificado, as aspas duplas podem ser omitidas. As entradas de log para os aplicativos especificados serão retornadas.

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

Uma lista separada por vírgulas de valores de nível de log entre aspas duplas ("). Se apenas um único nível for especificado, as aspas duplas podem ser omitidas. As entradas de log com o nível especificado serão retornadas. Dependendo do seu ambiente, níveis de log podem incluir: CRITICAL, DEBUG, EMERGENCY, ERROR, FATAL, INFO, SEVERE, TRACE, WARN ou ALERT.

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

O número total de entradas de log a serem exportadas.

--from <TIME>

O horário de início a ser utilizado para entradas de log. Nenhuma entrada de log anterior a este tempo será retornada. O <TIME> é especificado como um registro de data e hora do UNIX em segundos ou milissegundos.

--to <TIME>

O horário de término a ser usado para entradas de log. Nenhuma entrada de log posterior a este tempo será retornada. O <TIME> é especificado como um registro de data e hora do UNIX em segundos ou milissegundos.

--output <TYPE>

Tipo de saída produzida. Se o JSON for especificado, a saída será devolvida no formato JSON. Se não for especificado, a saída será retornada em formato tabular.

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

Um valor a ser procurado dentro do log. Todas as entradas de log contendo o <STRING> especificado serão retornadas.

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

As linhas de log que você deseja exportar. Os valores válidos são HEAD e TAIL. O HEAD especifica que as linhas de log serão exportadas desde a entrada mais antiga até a entrada mais recente. O TAIL especifica que as linhas de log serão exportadas em ordem inversa a partir da entrada mais recente ate a entrada mais antiga. Se não especificado, o padrão é TAIL.

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

Se especificado, um e-mail com um link para as informações de exportação será enviado para o e-mail especificado <ADDRESS>. O destinatário pode usar esse link para fazer o download das informações exportadas.

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

Use com --email para especificar uma linha de assunto a ser incluída no e-mail enviado.

--help | -h

Liste as opções disponíveis para o comando.

Exemplos

O seguinte são exemplos usando o comando ibmcloud logging export.

Exporte todos os logs para a chave de serviço fornecida.

ibmcloud logging export --service-key <SERVICE_KEY>

Entradas de log de exportação para a chave de serviço fornecida ocorrendo durante o intervalo de tempo especificado. Os registros de data e horário necessários para estar no formato UNIX. Por exemplo: 1614228407550.

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

Exporte as entradas de log de nível INFO e ERROR para a chave de serviço fornecida.

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

Exporte as entradas de log para os aplicativos metric-server e myapp para a chave de serviço fornecida.

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

Entradas de log de exportação para os hosts test-hostname e cloudantnosqldb para a chave de serviço fornecida.

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

Exportar entradas de log para a região eu-gb para a chave de serviço fornecida.

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

Exportar entradas de log contendo a sequência "nova linha" para a chave de serviço fornecida.

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

Exportar entradas de log contendo a sequência "nova linha" nas primeiras linhas de log (head) para a chave de serviço fornecida.

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

Exportar entradas de log em formato JSON do aplicativo myapp para a chave de serviço fornecida.

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

Envie um e-mail com um link que pode ser transferido por download para myemail@mycompany.com com o assunto "Emailing myapp logs". Neste exemplo o link permitirá que myemail@mycompany.com visualize a lista de todas as entradas de log para o aplicativo myapp para a chave de serviço fornecida no momento em que o comando foi executado.

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