---
name: "condor_dagman_metrics_repor"
section: "1"
platform: "linux"
package: "htcondor"
version: "8.6.8~dfsg.1-2+deb10u1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/condor_dagman_metrics_repor"
---

# condor\_dagman\_metrics\_repor(1)

the statistics of a DAGMan run to a central HTTP server

## Name

condor\_dagman\_metrics\_repor terReport - the statistics of a DAGMan run to a central HTTP server

## Synopsis

condor\_dagman\_metrics\_repor ter\[-s\] \[-u URL\] \[-t maxtime\] -f /path/to/metrics/file

## Description

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.

The data sent to the server is in JSON format. Here is an example of what is sent:

{\
\
    "client":"condor\_dagman",\
\
    "version":"8.1.0",\
\
    "planner":"/lfs1/devel/Pegasus/pegasus/bin/pegasus-plan",\
\
    "planner\_version":"4.3.0cvs",\
\
    "type":"metrics",\
\
    "wf\_uuid":"htcondor-test-job\_dagman\_metrics-A-subdag",\
\
    "root\_wf\_uuid":"htcondor-test-job\_dagman\_metrics-A",\
\
    "start\_time":1375313459.603,\
\
    "end\_time":1375313491.498,\
\
    "duration":31.895,\
\
    "exitcode":1,\
\
    "dagman\_id":"26",\
\
    "parent\_dagman\_id":"11",\
\
    "rescue\_dag\_number":0,\
\
    "jobs":4,\
\
    "jobs\_failed":1,\
\
    "jobs\_succeeded":3,\
\
    "dag\_jobs":0,\
\
    "dag\_jobs\_failed":0,\
\
    "dag\_jobs\_succeeded":0,\
\
    "total\_jobs":4,\
\
    "total\_jobs\_run":4,\
\
    "total\_job\_time":0.000,\
\
    "dag\_status":2\
 }

Metrics are sent only if the condor\_dagmanprocess has PEGASUS\_METRICSset to Truein its environment, and the CONDOR\_DEVELOPERSconfiguration variable does nothave the value NONE.

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:

**PEGASUS\_USER\_METRICS\_DEFAULT\_SERVER**

-

  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.

-

  **PEGASUS\_USER\_METRICS\_SERVER**

-

  A comma separated list of URLs of servers that will receive the data, in addition to the default server.

-

  The -fargument specifies the metrics file to be sent to the HTTP server.

## Options

**-s**

-

  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.

-

  **-u URL**

-

  Overrides setting of the environment variable PEGASUS\_USER\_METRICS\_DEFAULT\_SERVER. This option is unused by condor\_dagman; it is for testing by developers.

-

  **-t maxtime**

-

  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\_TIMEOUTconfiguration variable.

-

  **-f metrics\_file**

-

  The name of the file containing the metrics values to be reported.

-

  ## Exit Status

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.

## Author

Center for High Throughput Computing, University of Wisconsin-Madison

## 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.