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

# Instrumentation Django

export const VersionRequirements = ({versions = []}) => {
  if (!Array.isArray(versions) || versions.length === 0) {
    return null;
  }
  const boundaries = {
    upper: " or lower",
    exact: "",
    lower: " or higher"
  };
  const containerStyle = {
    marginTop: "0.5rem",
    marginBottom: "1.5rem"
  };
  const lineStyle = {
    display: "block",
    margin: "0 0 0.35rem 0",
    fontSize: "0.875rem",
    lineHeight: "1.4"
  };
  const pillBaseStyle = {
    display: "inline-block",
    padding: "0.1em 0.4em",
    borderRadius: "0.25rem",
    border: "1px solid",
    fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
    fontSize: "0.85em",
    fontWeight: 500
  };
  const pillColors = {
    "AppSignal for Elixir": {
      background: "#f3e8ff",
      borderColor: "#e9d5ff",
      color: "#9333ea"
    },
    "AppSignal for Front-end": {
      background: "#fef9c3",
      borderColor: "#fde68a",
      color: "#ca8a04"
    },
    "AppSignal for Go": {
      background: "#ccfbf1",
      borderColor: "#99f6e4",
      color: "#0d9488"
    },
    "AppSignal for JavaScript": {
      background: "#fef9c3",
      borderColor: "#fde68a",
      color: "#ca8a04"
    },
    "AppSignal for Node.js": {
      background: "#dcfce7",
      borderColor: "#bbf7d0",
      color: "#16a34a"
    },
    "AppSignal for Python": {
      background: "#dbeafe",
      borderColor: "#bfdbfe",
      color: "#2563eb"
    },
    "AppSignal for Ruby": {
      background: "#fee2e2",
      borderColor: "#fecaca",
      color: "#dc2626"
    },
    "AppSignal for Rust": {
      background: "#ffedd5",
      borderColor: "#fed7aa",
      color: "#ea580c"
    }
  };
  const defaultPillColor = {
    background: "#f4f4f5",
    borderColor: "#e4e4e7",
    color: "#52525b"
  };
  const getPillStyle = name => ({
    ...pillBaseStyle,
    ...pillColors[name] || defaultPillColor
  });
  const getBoundText = bound => {
    return boundaries[bound] || boundaries.lower;
  };
  return <div style={containerStyle}>
      {versions.map((v, i) => <p key={`${v.name}-${v.version}-${v.bound || "lower"}-${i}`} style={lineStyle}>
          This feature requires{" "}
          <code style={getPillStyle(v.name)}>{v.name}</code> version {v.version}
          {getBoundText(v.bound)}.
        </p>)}
    </div>;
};

<VersionRequirements
  versions={[
{ name: "AppSignal for Python", version: "0.1.0" },
{ name: "Django", version: "1.10" }
]}
/>

[Django](https://www.djangoproject.com/) est un framework web Python de haut niveau qui encourage le développement rapide et une conception propre et pragmatique.

## Installation

<Note>
  🐍 N'oubliez pas d'[installer le paquet AppSignal for Python](/python/installation) dans votre application au préalable.
</Note>

Tout d'abord, installez le package `opentelemetry-instrumentation-django`, ainsi que les packages `opentelemetry-instrumentation-wsgi` et `opentelemetry-instrumentation-asgi`. Pour ajouter ces packages à votre projet, ajoutez la ligne suivante à votre fichier `requirements.txt` :

<CodeGroup>
  ```python Python theme={null}
  # requirements.txt
  opentelemetry-instrumentation-django
  opentelemetry-instrumentation-wsgi
  opentelemetry-instrumentation-asgi
  ```
</CodeGroup>

Pour instrumenter les requêtes effectuées via l'ORM Django, installez l'instrumentation pour la base de données SQL utilisée par votre application :

* [MySQL](/python/instrumentations/mysql)
* [PostgreSQL](/python/instrumentations/postgresql)
* [SQLite](/python/instrumentations/sqlite)

<Note>
  L'intégration AppSignal for Python utilisera automatiquement cette instrumentation lorsque le paquet correspondant est installé. Pour désactiver cette instrumentation sans désinstaller le paquet, utilisez l'[option de configuration `disable_default_instrumentations`](/python/configuration/options#option-disable_default_instrumentations).
</Note>

## Configuration de développement

Django nécessite une configuration supplémentaire, car c'est généralement la première chose démarrée dans une application.

Comme indiqué dans l'exemple ci-dessous, le module `appsignal` doit être importé dans le fichier `manage.py`. Ensuite, dans la méthode `main`, la méthode `appsignal.start` doit être appelée pour initialiser l'instrumentation configurée dans le fichier `__appsignal__.py`.

<CodeGroup>
  ```python Python theme={null}
  # manage.py
  #!/usr/bin/env python
  """Django's command-line utility for administrative tasks."""
  import os
  import sys

  # Add this import statement
  import appsignal

  def main():
      """Run administrative tasks."""
      os.environ.setdefault('DJANGO_SETTINGS_MODULE', '<YOUR_APP_NAME_HERE>.settings')

      # Add this method call
      appsignal.start()

      try:
          from django.core.management import execute_from_command_line
      except ImportError as exc:
          raise ImportError(
              "Couldn't import Django. Are you sure it's installed and "
              "available on your PYTHONPATH environment variable? Did you "
              "forget to activate a virtual environment?"
          ) from exc
      execute_from_command_line(sys.argv)

  if __name__ == '__main__':
      main()
  ```
</CodeGroup>

## Configuration de production (WSGI/ASGI)

En production, il est recommandé d'exécuter Django avec un serveur WSGI ou ASGI, tel que
Gunicorn ou Uvicorn. Dans ce scénario, le fichier `manage.py` modifié dans la configuration de développement ci-dessus n'est jamais appelé.

Pour instrumenter votre application lorsqu'elle est démarrée en tant que serveur WSGI ou ASGI, ajoutez ce qui suit
au fichier `wsgi.py` de votre projet, si vous utilisez un serveur WSGI :

<CodeGroup>
  ```python Python theme={null}
  # wsgi.py
  import os

  # Add this import statement
  import appsignal

  from django.core.wsgi import get_wsgi_application

  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_app.settings')

  # Add this method call
  appsignal.start()

  application = get_wsgi_application()
  ```
</CodeGroup>

Ou au fichier `asgi.py` de votre projet, si vous utilisez un serveur ASGI :

<CodeGroup>
  ```python Python theme={null}
  # asgi.py
  import os

  # Add this import statement
  import appsignal

  from django.core.asgi import get_asgi_application

  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_app.settings')

  # Add this method call
  appsignal.start()

  application = get_asgi_application()
  ```
</CodeGroup>

## Fonctionnalités

Par défaut, l'instrumentation Django signale les paramètres des requêtes entrantes, comme les chaînes de requête et les paramètres de routage.

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