Created /api/v1/keys, access-requests, telemetry, agent. Documented endpoints at /api/v1/docs

app/apps/telemetry/admin.py

@@ -0,0 +1,11 @@
+from django.contrib import admin
+
+from .models import TelemetryEvent
+
+
+@admin.register(TelemetryEvent)
+class TelemetryEventAdmin(admin.ModelAdmin):
+    list_display = ("id", "event_type", "server", "user", "success", "source", "created_at")
+    list_filter = ("success", "source", "event_type")
+    search_fields = ("event_type", "message", "server__display_name", "user__username")
+    ordering = ("-created_at",)

app/apps/telemetry/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class TelemetryConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "apps.telemetry"
+    verbose_name = "Telemetry"

app/apps/telemetry/migrations/0001_initial.py

@@ -0,0 +1,73 @@
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+import django.utils.timezone
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+        ("servers", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="TelemetryEvent",
+            fields=[
+                ("id", models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name="ID")),
+                ("event_type", models.CharField(db_index=True, max_length=64)),
+                ("success", models.BooleanField(db_index=True, default=True)),
+                (
+                    "source",
+                    models.CharField(
+                        choices=[
+                            ("agent", "Agent"),
+                            ("api", "API"),
+                            ("ui", "UI"),
+                            ("system", "System"),
+                        ],
+                        db_index=True,
+                        default="api",
+                        max_length=16,
+                    ),
+                ),
+                ("message", models.TextField(blank=True)),
+                ("metadata", models.JSONField(blank=True, default=dict)),
+                ("created_at", models.DateTimeField(db_index=True, default=django.utils.timezone.now, editable=False)),
+                (
+                    "server",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="telemetry_events",
+                        to="servers.server",
+                    ),
+                ),
+                (
+                    "user",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="telemetry_events",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Telemetry event",
+                "verbose_name_plural": "Telemetry events",
+                "ordering": ["-created_at"],
+                "indexes": [
+                    models.Index(fields=["created_at"], name="telemetry_created_at_idx"),
+                    models.Index(fields=["event_type"], name="telemetry_event_type_idx"),
+                    models.Index(fields=["server", "created_at"], name="telemetry_server_created_idx"),
+                    models.Index(fields=["user", "created_at"], name="telemetry_user_created_idx"),
+                ],
+            },
+        ),
+    ]

app/apps/telemetry/models.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from django.conf import settings
+from django.db import models
+from django.utils import timezone
+
+from apps.servers.models import Server
+
+
+class TelemetryEvent(models.Model):
+    class Source(models.TextChoices):
+        AGENT = "agent", "Agent"
+        API = "api", "API"
+        UI = "ui", "UI"
+        SYSTEM = "system", "System"
+
+    event_type = models.CharField(max_length=64, db_index=True)
+    server = models.ForeignKey(
+        Server, null=True, blank=True, on_delete=models.SET_NULL, related_name="telemetry_events"
+    )
+    user = models.ForeignKey(
+        settings.AUTH_USER_MODEL,
+        null=True,
+        blank=True,
+        on_delete=models.SET_NULL,
+        related_name="telemetry_events",
+    )
+    success = models.BooleanField(default=True, db_index=True)
+    source = models.CharField(
+        max_length=16, choices=Source.choices, default=Source.API, db_index=True
+    )
+    message = models.TextField(blank=True)
+    metadata = models.JSONField(default=dict, blank=True)
+    created_at = models.DateTimeField(default=timezone.now, editable=False, db_index=True)
+
+    class Meta:
+        verbose_name = "Telemetry event"
+        verbose_name_plural = "Telemetry events"
+        indexes = [
+            models.Index(fields=["created_at"], name="telemetry_created_at_idx"),
+            models.Index(fields=["event_type"], name="telemetry_event_type_idx"),
+            models.Index(fields=["server", "created_at"], name="telemetry_server_created_idx"),
+            models.Index(fields=["user", "created_at"], name="telemetry_user_created_idx"),
+        ]
+        ordering = ["-created_at"]
+
+    def __str__(self) -> str:
+        return f"{self.event_type} ({'ok' if self.success else 'fail'})"