[ 
https://issues.apache.org/jira/browse/YARN-10443?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17199860#comment-17199860
 ] 

Hadoop QA commented on YARN-10443:
----------------------------------

| (/) *{color:green}+1 overall{color}* |
\\
\\
|| Vote || Subsystem || Runtime || Comment ||
| {color:blue}0{color} | {color:blue} reexec {color} | {color:blue}  1m  
9s{color} | {color:blue} Docker mode activated. {color} |
|| || || || {color:brown} Prechecks {color} ||
| {color:green}+1{color} | {color:green} dupname {color} | {color:green}  0m  
0s{color} | {color:green} No case conflicting files found. {color} |
| {color:blue}0{color} | {color:blue} markdownlint {color} | {color:blue}  0m  
0s{color} | {color:blue} markdownlint was not available. {color} |
| {color:green}+1{color} | {color:green} @author {color} | {color:green}  0m  
0s{color} | {color:green} The patch does not contain any @author tags. {color} |
|| || || || {color:brown} trunk Compile Tests {color} ||
| {color:green}+1{color} | {color:green} mvninstall {color} | {color:green} 31m 
43s{color} | {color:green} trunk passed {color} |
| {color:green}+1{color} | {color:green} mvnsite {color} | {color:green}  0m 
24s{color} | {color:green} trunk passed {color} |
| {color:green}+1{color} | {color:green} shadedclient {color} | {color:green} 
47m 52s{color} | {color:green} branch has no errors when building and testing 
our client artifacts. {color} |
|| || || || {color:brown} Patch Compile Tests {color} ||
| {color:green}+1{color} | {color:green} mvninstall {color} | {color:green}  0m 
11s{color} | {color:green} the patch passed {color} |
| {color:green}+1{color} | {color:green} mvnsite {color} | {color:green}  0m 
16s{color} | {color:green} the patch passed {color} |
| {color:green}+1{color} | {color:green} whitespace {color} | {color:green}  0m 
 0s{color} | {color:green} The patch has no whitespace issues. {color} |
| {color:green}+1{color} | {color:green} shadedclient {color} | {color:green} 
15m 32s{color} | {color:green} patch has no errors when building and testing 
our client artifacts. {color} |
|| || || || {color:brown} Other Tests {color} ||
| {color:green}+1{color} | {color:green} asflicense {color} | {color:green}  0m 
29s{color} | {color:green} The patch does not generate ASF License warnings. 
{color} |
| {color:black}{color} | {color:black} {color} | {color:black} 67m 14s{color} | 
{color:black} {color} |
\\
\\
|| Subsystem || Report/Notes ||
| Docker | ClientAPI=1.40 ServerAPI=1.40 base: 
https://ci-hadoop.apache.org/job/hadoop-multibranch/job/PR-2325/1/artifact/out/Dockerfile
 |
| GITHUB PR | https://github.com/apache/hadoop/pull/2325 |
| JIRA Issue | YARN-10443 |
| Optional Tests | dupname asflicense mvnsite markdownlint |
| uname | Linux 7291926c8f02 4.15.0-112-generic #113-Ubuntu SMP Thu Jul 9 
23:41:39 UTC 2020 x86_64 x86_64 x86_64 GNU/Linux |
| Build tool | maven |
| Personality | dev-support/bin/hadoop.sh |
| git revision | trunk / 6b5d9e2334b |
| Max. process+thread count | 308 (vs. ulimit of 5500) |
| modules | C: hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site U: 
hadoop-yarn-project/hadoop-yarn/hadoop-yarn-site |
| Console output | 
https://ci-hadoop.apache.org/job/hadoop-multibranch/job/PR-2325/1/console |
| versions | git=2.17.1 maven=3.6.0 |
| Powered by | Apache Yetus 0.13.0-SNAPSHOT https://yetus.apache.org |


This message was automatically generated.



> Document options of logs CLI
> ----------------------------
>
>                 Key: YARN-10443
>                 URL: https://issues.apache.org/jira/browse/YARN-10443
>             Project: Hadoop YARN
>          Issue Type: Bug
>          Components: yarn
>    Affects Versions: 3.3.0
>            Reporter: Adam Antal
>            Assignee: Ankit Kumar
>            Priority: Major
>         Attachments: YARN-10443.001.patch
>
>
> It's bugging me a lot that the YARN logs CLI is poorly documented. I always 
> have to type {{yarn logs -help}} to see the full list of supported commands. 
> It would be nice to have it nicely documented in our website.
> Current 
> [documentation|https://hadoop.apache.org/docs/r3.3.0/hadoop-yarn/hadoop-yarn-site/YarnCommands.html#logs]
>  in the website shows only 5 supported options.
> The output of the help command however shows more:
> {noformat}
> Retrieve logs for YARN applications.
> usage: yarn logs -applicationId <application ID> [OPTIONS]
> general options are:
>  -am <AM Containers>                          Prints the AM Container logs
>                                               for this application.
>                                               Specify comma-separated
>                                               value to get logs for
>                                               related AM Container. For
>                                               example, If we specify -am
>                                               1,2, we will get the logs
>                                               for the first AM Container
>                                               as well as the second AM
>                                               Container. To get logs for
>                                               all AM Containers, use -am
>                                               ALL. To get logs for the
>                                               latest AM Container, use -am
>                                               -1. By default, it will
>                                               print all available logs.
>                                               Work with -log_files to get
>                                               only specific logs.
>  -appOwner <Application Owner>                AppOwner (assumed to be
>                                               current user if not
>                                               specified)
>  -client_max_retries <Max Retries>            Set max retry number for a
>                                               retry client to get the
>                                               container logs for the
>                                               running applications. Use a
>                                               negative value to make retry
>                                               forever. The default value
>                                               is 30.
>  -client_retry_interval_ms <Retry Interval>   Work with
>                                               --client_max_retries to
>                                               create a retry client. The
>                                               default value is 1000.
>  -clusterId <Cluster ID>                      ClusterId. By default, it
>                                               will take default cluster id
>                                               from the RM
>  -containerId <Container ID>                  ContainerId. By default, it
>                                               will print all available
>                                               logs. Work with -log_files
>                                               to get only specific logs.
>                                               If specified, the
>                                               applicationId can be omitted
>  -help                                        Displays help for all
>                                               commands.
>  -list_nodes                                  Show the list of nodes that
>                                               successfully aggregated
>                                               logs. This option can only
>                                               be used with finished
>                                               applications.
>  -log_files <Log File Name>                   Specify comma-separated
>                                               value to get exact matched
>                                               log files. Use "ALL" or "*"
>                                               to fetch all the log files
>                                               for the container.
>  -log_files_pattern <Log File Pattern>        Specify comma-separated
>                                               value to get matched log
>                                               files by using java regex.
>                                               Use ".*" to fetch all the
>                                               log files for the container.
>  -nodeAddress <Node Address>                  NodeAddress in the format
>                                               nodename:port
>  -out <Local Directory>                       Local directory for storing
>                                               individual container logs.
>                                               The container logs will be
>                                               stored based on the node the
>                                               container ran on.
>  -show_application_log_info                   Show the containerIds which
>                                               belong to the specific
>                                               Application. You can combine
>                                               this with --nodeAddress to
>                                               get containerIds for all the
>                                               containers on the specific
>                                               NodeManager.
>  -show_container_log_info                     Show the container log
>                                               metadata, including log-file
>                                               names, the size of the log
>                                               files. You can combine this
>                                               with --containerId to get
>                                               log metadata for the
>                                               specific container, or with
>                                               --nodeAddress to get log
>                                               metadata for all the
>                                               containers on the specific
>                                               NodeManager.
>  -size <size>                                 Prints the log file's first
>                                               'n' bytes or the last 'n'
>                                               bytes. Use negative values
>                                               as bytes to read from the
>                                               end and positive values as
>                                               bytes to read from the
>                                               beginning.
>  -size_limit_mb <Size Limit>                  Use this option to limit the
>                                               size of the total logs which
>                                               could be fetched. By
>                                               default, we only allow to
>                                               fetch at most 10240 MB logs.
>                                               If the total log size is
>                                               larger than the specified
>                                               number, the CLI would fail.
>                                               The user could specify -1 to
>                                               ignore the size limit and
>                                               fetch all logs.
> {noformat}



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: yarn-issues-unsubscr...@hadoop.apache.org
For additional commands, e-mail: yarn-issues-h...@hadoop.apache.org

Reply via email to