deployphp/deployer

<!-- DO NOT EDIT THIS FILE! -->
<!-- Instead edit contrib/newrelic.php -->
<!-- Then run bin/docgen -->

# Newrelic Recipe

```php
require 'contrib/newrelic.php';
```

[Source](/contrib/newrelic.php)



## Configuration
- `newrelic_app_id` – newrelic's app id
- `newrelic_api_key` – newrelic's api key
- `newrelic_description` – message to send
- `newrelic_endpoint` – newrelic's REST API endpoint
## Usage
Since you should only notify New Relic of a successful deployment, the `newrelic:notify` task should be executed right at the end.
```php
after('deploy', 'newrelic:notify');
```


## Configuration
### newrelic_app_id
[Source](https://github.com/deployphp/deployer/blob/master/contrib/newrelic.php#L24)


:::info Required
Throws exception if not set.
:::




### newrelic_description
[Source](https://github.com/deployphp/deployer/blob/master/contrib/newrelic.php#L28)



```php title="Default value"
return runLocally('git log -n 1 --format="%an: %s" | tr \'"\' "\'"');
```


### newrelic_revision
[Source](https://github.com/deployphp/deployer/blob/master/contrib/newrelic.php#L32)



```php title="Default value"
return runLocally('git log -n 1 --format="%h"');
```


### newrelic_endpoint
[Source](https://github.com/deployphp/deployer/blob/master/contrib/newrelic.php#L36)



```php title="Default value"
'api.newrelic.com'
```



## Tasks

### newrelic\:notify {#newrelic-notify}
[Source](https://github.com/deployphp/deployer/blob/master/contrib/newrelic.php#L39)

Notifies New Relic of deployment.