.\"Man page for condor_dagman_metrics_repor 
.\"Generated by makeman on Tue May 29 00:38:53 2018
.TH condor_dagman_metrics_repor  1 "May 2018"
.SH Name
.P
condor_dagman_metrics_repor terReport \- the statistics of a DAGMan run to a central HTTP server 
.P

.P
.SH Synopsis
condor_dagman_metrics_repor ter[-s] [-u URL] [-t maxtime] -f /path/to/metrics/file
.P
.SH Description
.P
condor_dagman_metrics_reporteranonymously reports metrics from a DAGMan workflow to a central server. The reporting of workflow metrics is only enabled for DAGMan workflows run under Pegasus; metrics reporting has been requested by Pegasus' funding sources: see http://pegasus.isi.edu/wms/docs/latest/funding_citing_usage.php#usage_statisticsand https://confluence.pegasus.isi.edu/display/pegasus/DAGMan+Metrics+Reportingfor the requirements to collect this data. 
.P
The data sent to the server is in JSON format. Here is an example of what is sent: 
.P

.br
{
.br
   "client":"condor_dagman",
.br
   "version":"8.1.0",
.br
   "planner":"/lfs1/devel/Pegasus/pegasus/bin/pegasus-plan",
.br
   "planner_version":"4.3.0cvs",
.br
   "type":"metrics",
.br
   "wf_uuid":"htcondor-test-job_dagman_metrics-A-subdag",
.br
   "root_wf_uuid":"htcondor-test-job_dagman_metrics-A",
.br
   "start_time":1375313459.603,
.br
   "end_time":1375313491.498,
.br
   "duration":31.895,
.br
   "exitcode":1,
.br
   "dagman_id":"26",
.br
   "parent_dagman_id":"11",
.br
   "rescue_dag_number":0,
.br
   "jobs":4,
.br
   "jobs_failed":1,
.br
   "jobs_succeeded":3,
.br
   "dag_jobs":0,
.br
   "dag_jobs_failed":0,
.br
   "dag_jobs_succeeded":0,
.br
   "total_jobs":4,
.br
   "total_jobs_run":4,
.br
   "total_job_time":0.000,
.br
   "dag_status":2
.br
}
.P
Metrics are sent only if the condor_dagmanprocess has  PEGASUS_METRICS set to  True in its environment, and the  CONDOR_DEVELOPERS configuration variable does nothave the value  NONE . 
.P
Ordinarily, this program will be run by condor_dagman, and users do not need to interact with it. This program uses the following environment variables: 
.P

.B  PEGASUS_USER_METRICS_DEFAULT_SERVER 
.IP "" 3
The URL of the default server to which to send the data. It defaults to  http://metrics.pegasus.isi.edu/metrics . It can be overridden at the command line with the -uoption. 
.IP "" 3
.P
.B  PEGASUS_USER_METRICS_SERVER 
.IP "" 3
A comma separated list of URLs of servers that will receive the data, in addition to the default server. 
.IP "" 3
.P
The -fargument specifies the metrics file to be sent to the HTTP server. 
.P
.SH Options
.P

.B -s
.IP "" 3
Sleep for a random number of seconds between 1 and 10, before attempting to send data. This option is used to space out the reporting from any sub-DAGs when a DAG is removed. 
.IP "" 3
.P
.B -u URL
.IP "" 3
Overrides setting of the environment variable  PEGASUS_USER_METRICS_DEFAULT_SERVER . This option is unused by condor_dagman; it is for testing by developers. 
.IP "" 3
.P
.B -t maxtime
.IP "" 3
A maximum time in seconds that defaults to 100 seconds, setting a limit on the amount of time this program will wait for communication from the server. A setting of zero will result in a single attempt per server. condor_dagmanretrieves this value from the  DAGMAN_PEGASUS_REPORT_TIMEOUT configuration variable. 
.IP "" 3
.P
.B -f metrics_file
.IP "" 3
The name of the file containing the metrics values to be reported. 
.IP "" 3
.P

.SH Exit Status
.P
condor_dagman_metrics_reporterwill exit with a status value of 0 (zero) upon success, and it will exit with a value of 1 (one) upon failure. 
.P
.SH Author
Center for High Throughput Computing, University of Wisconsin-Madison 
.SH Copyright
Copyright (C) 1990-2016 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.