[ 
https://issues.apache.org/jira/browse/GEODE-2379?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Jinmei Liao updated GEODE-2379:
-------------------------------
    Description: 
the new command help: 

NAME
    export logs
IS AVAILABLE
    false
SYNOPSIS
    Export the log files for a member or members.
SYNTAX
    export logs [--dir=value] [--group=value(,value)*] 
[--member=value(,value)*] [--log-level=value] [--only-log-level=value] 
[--merge-log=value] [--start-time=value] [--end-time=value] 
[--logs-only(=value)?] [--stats-only(=value)?]
PARAMETERS
    dir
        Local directory to which log files will be written. This is only used 
when you are exporting logs using http connection. If not specified, user.dir 
will be used.
        Required: false
    group
        Group of members whose log files will be exported.
        Required: false
    member
        Name/Id of the member whose log files will be exported.
        Required: false
    log-level
        Minimum level of log entries to export. Valid values are: fatal, error, 
warn, info, debug, trace and all.  The default is "INFO".
        Required: false
        Default (if the parameter is not specified): INFO
    only-log-level
        Whether to only include those entries that exactly match the 
--log-level specified.
        Required: false
        Default (if the parameter is not specified): false
    merge-log
        Whether to merge logs after exporting to the target directory.  -- 
deprecated
        Required: false
        Default (if the parameter is not specified): false
    start-time
        Log entries that occurred after this time will be exported. The default 
is no limit. Format: yyyy/MM/dd/HH/mm/ss/SSS/z OR yyyy/MM/dd
        Required: false
    end-time
        Log entries that occurred before this time will be exported. The 
default is no limit. Format: yyyy/MM/dd/HH/mm/ss/SSS/z OR yyyy/MM/dd
        Required: false
    logs-only
        Whether to only export logs
        Required: false
        Default (if the parameter is specified without value): true
        Default (if the parameter is not specified): false
    stats-only
        Whether to only export statistics
        Required: false
        Default (if the parameter is specified without value): true
        Default (if the parameter is not specified): false

changes are:  --dir is not required anymore. added logs-only and stats-only 
options. --merge-log is deprecated, group and member can be comma separated 
strings.

Also note down in the docs: when this command is executed over jmx, the 
exported logs will be saved as exportedlogs_xxx.zip in the connected locator's 
working directory. If executed over http, the zip will be saved in specified 
dir in the user's client machine.

  was:We would like a single gfsh command to collect and export all logfiles 
and stat files into a single package. This package (zipfile) can then be saved 
and attached to emails and Jira tickets to help evaluate the Geode cluster 
status.


> Document new behavior of export logs
> ------------------------------------
>
>                 Key: GEODE-2379
>                 URL: https://issues.apache.org/jira/browse/GEODE-2379
>             Project: Geode
>          Issue Type: Sub-task
>          Components: docs
>            Reporter: Joey McAllister
>
> the new command help: 
> NAME
>     export logs
> IS AVAILABLE
>     false
> SYNOPSIS
>     Export the log files for a member or members.
> SYNTAX
>     export logs [--dir=value] [--group=value(,value)*] 
> [--member=value(,value)*] [--log-level=value] [--only-log-level=value] 
> [--merge-log=value] [--start-time=value] [--end-time=value] 
> [--logs-only(=value)?] [--stats-only(=value)?]
> PARAMETERS
>     dir
>         Local directory to which log files will be written. This is only used 
> when you are exporting logs using http connection. If not specified, user.dir 
> will be used.
>         Required: false
>     group
>         Group of members whose log files will be exported.
>         Required: false
>     member
>         Name/Id of the member whose log files will be exported.
>         Required: false
>     log-level
>         Minimum level of log entries to export. Valid values are: fatal, 
> error, warn, info, debug, trace and all.  The default is "INFO".
>         Required: false
>         Default (if the parameter is not specified): INFO
>     only-log-level
>         Whether to only include those entries that exactly match the 
> --log-level specified.
>         Required: false
>         Default (if the parameter is not specified): false
>     merge-log
>         Whether to merge logs after exporting to the target directory.  -- 
> deprecated
>         Required: false
>         Default (if the parameter is not specified): false
>     start-time
>         Log entries that occurred after this time will be exported. The 
> default is no limit. Format: yyyy/MM/dd/HH/mm/ss/SSS/z OR yyyy/MM/dd
>         Required: false
>     end-time
>         Log entries that occurred before this time will be exported. The 
> default is no limit. Format: yyyy/MM/dd/HH/mm/ss/SSS/z OR yyyy/MM/dd
>         Required: false
>     logs-only
>         Whether to only export logs
>         Required: false
>         Default (if the parameter is specified without value): true
>         Default (if the parameter is not specified): false
>     stats-only
>         Whether to only export statistics
>         Required: false
>         Default (if the parameter is specified without value): true
>         Default (if the parameter is not specified): false
> changes are:  --dir is not required anymore. added logs-only and stats-only 
> options. --merge-log is deprecated, group and member can be comma separated 
> strings.
> Also note down in the docs: when this command is executed over jmx, the 
> exported logs will be saved as exportedlogs_xxx.zip in the connected 
> locator's working directory. If executed over http, the zip will be saved in 
> specified dir in the user's client machine.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Reply via email to