> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs Heroku

<Warning>
  🔐 N'envoyez pas d'<strong>informations personnelles identifiables (PII)</strong> à AppSignal. Filtrez les PII (par exemple, noms, e-mails) des journaux et utilisez un identifiant, un hash ou un identifiant pseudonymisé à la place. <br /> <br /> Pour les **entités couvertes par la HIPAA**, plus d'informations sur la signature d'un Business Associate Agreement (BAA) sont disponibles dans notre [documentation Business Add-Ons](/support/business-add-ons).
</Warning>

## Applications Cedar (plateforme héritée)

### Supprimer les anciens log drains

<Tip>
  Cette configuration de log drain Heroku enverra à la fois les logs et les
  métriques à AppSignal. Pour n'envoyer que les métriques à AppSignal, suivez
  plutôt la configuration de log drain Heroku [dans notre documentation
  Heroku](/heroku/setup).
</Tip>

Avant de créer un nouveau log drain pour AppSignal, vous devez supprimer tous les log drains AppSignal préexistants. Vous pouvez vérifier les log drains actifs existants avec la commande ci-dessous, où `myapp` est le nom de votre application Heroku :

<CodeGroup>
  ```shell Shell theme={null}
  heroku drains -a myapp
  ```
</CodeGroup>

S'il existe des log drains AppSignal actifs, vous pouvez les supprimer avec la commande suivante :

<CodeGroup>
  ```shell Shell theme={null}
  heroku drains:remove -a myapp <url>
  ```
</CodeGroup>

*Remplacez `<url>` ci-dessus par l'URL du log drain que vous essayez de supprimer.*

### Ajouter un nouveau log drain

Une fois les log drains actifs supprimés, [suivez les instructions pour créer une source de log Heroku](/logging/configuration#creating-a-log-source).

Une fois la source de log créée, utilisez la commande ci-dessous pour créer un nouveau log drain.

<CodeGroup>
  ```shell Shell theme={null}
  heroku drains:add "https://appsignal-endpoint.net/logplex?api_key=YOUR_LOG_SOURCE_API_KEY"
  ```
</CodeGroup>

Remplacez `YOUR_LOG_SOURCE_API_KEY` par la clé fournie lors de la création d'une source de log.

Une fois connecté, les logs devraient apparaître dans AppSignal. Si vous ne voyez toujours aucun log,
veuillez [nous contacter](mailto:support@appsignal.com) pour obtenir de l'aide.

### Analyse de la gravité

Par défaut, Heroku envoie tous les logs avec une gravité INFO. Et comme le contenu des messages logdrain peut dépendre de la source (add-ons, application, routeur Heroku, etc.),
il existe plusieurs façons de remplacer la gravité par défaut.

#### Format de log

Définissez un format de log et remplacez la gravité.

Vous pouvez définir le format de vos lignes de log dans la source sur « logfmt » et émettre la chaîne suivante dans votre ligne de log : `severity=warning`. Cela remplacera la gravité par défaut `INFO` par `WARNING`.

#### Analyse de la gravité

Lors de l'ajout d'une source de log Heroku dans AppSignal, il y a une case à cocher pour activer « Severity parsing ».

Lorsqu'elle est cochée, nous tenterons d'analyser toute chaîne de gravité valide dans le message de log. Nous ne le faisons que lorsque les alternatives n'ont produit aucun résultat (par exemple, si vous définissez le format de log source sur logfmt et émettez un attribut « severity », celui-ci est utilisé à la place de la gravité analysée).

Les chaînes suivantes sont considérées comme des gravités valides ; elles peuvent être en majuscules, minuscules ou casse mixte :

* TRACE
* DEBUG
* INFO
* NOTICE
* WARNING
* WARN
* ERR
* ERROR
* CRIT
* CRITICAL
* ALERT
* EMERG
* PANIC
* FATAL

Nous ne considérerons pas ces chaînes comme une gravité si elles font partie d'un mot.
Les gravités encadrées par des blocs sont considérées comme des gravités, par exemple :

Celles-ci sont analysées comme des gravités :

```shell Shell theme={null}
[oban] [error] invalid query
ERROR  - My app is broken
error something went wrong
[Error] this is a valid error severity
```

*Notez que cela signifie que toute chaîne de gravité en minuscules (info/debug/warning/trace/etc) n'importe où dans la ligne de log modifiera la gravité du log.*

Celles-ci ne sont pas analysées comme des gravités :

```shell Shell theme={null}
ErrorClass
error: something went wrong
The doctor was panicking just as much as the patient
```

## Applications Fir

Pour envoyer les logs de votre application Heroku Fir à AppSignal, suivez les [étapes de configuration pour les applications de génération Heroku Fir](/heroku/setup#fir-applications). AppSignal ingérera automatiquement les logs de votre application via les exportateurs OpenTelemetry HTTP, ou tout log de `stdout` et `stderr` via un [Heroku Telemetry Drain](https://devcenter.heroku.com/articles/log-drains).