trace on server start

guardrails_api/__init__.py

@@ -1 +1 @@
-__version__ = "0.0.1"
+__version__ = "0.0.2"

guardrails_api/app.py

@@ -9,10 +9,12 @@
 from opentelemetry.instrumentation.flask import FlaskInstrumentor
 from guardrails_api.clients.postgres_client import postgres_is_enabled
 from guardrails_api.otel import otel_is_disabled, initialize
+from guardrails_api.utils.trace_server_start_if_enabled import trace_server_start_if_enabled
 from guardrails_api.clients.cache_client import CacheClient
 from rich.console import Console
 from rich.rule import Rule
 
+
 # TODO: Move this to a separate file
 class OverrideJsonProvider(DefaultJSONProvider):
     def default(self, o):
@@ -50,6 +52,7 @@ def register_config(config: Optional[str] = None):
 def create_app(
     env: Optional[str] = None, config: Optional[str] = None, port: Optional[int] = None
 ):
+    trace_server_start_if_enabled()
     # used to print user-facing messages during server startup
     console = Console()
 

guardrails_api/utils/has_internet_connection.py

@@ -0,0 +1,9 @@
+import requests
+
+
+def has_internet_connection() -> bool:
+    try:
+        requests.get("https://www.guardrailsai.com/")
+        return True
+    except requests.ConnectionError:
+        return False

guardrails_api/utils/trace_server_start_if_enabled.py

@@ -0,0 +1,24 @@
+import platform
+from guardrails.classes.credentials import Credentials
+from guardrails.version import GUARDRAILS_VERSION
+from guardrails_api.utils.has_internet_connection import has_internet_connection
+
+
+def trace_server_start_if_enabled():
+    config = Credentials.from_rc_file()
+    if config.enable_metrics is True and has_internet_connection():
+        from guardrails.utils.hub_telemetry_utils import HubTelemetry
+        HubTelemetry().create_new_span(
+            "guardrails-api/start",
+            [
+                ("guardrails-version", GUARDRAILS_VERSION),
+                ("python-version", platform.python_version()),
+                ("system", platform.system()),
+                ("platform", platform.platform()),
+                ("arch", platform.architecture()[0]),
+                ("machine", platform.machine()),
+                ("processor", platform.processor()),
+            ],
+            True,
+            False,
+        )

pyproject.toml

@@ -10,7 +10,7 @@ readme = "README.md"
 keywords = ["Guardrails", "Guardrails AI", "Guardrails API", "Guardrails API"]
 requires-python = ">= 3.8.1"
 dependencies = [
-    "guardrails-ai>=0.5.0a11",
+    "guardrails-ai>=0.5.6",
     "flask>=3.0.3,<4",
     "Flask-SQLAlchemy>=3.1.1,<4",
     "Flask-Caching>=2.3.0,<3",
@@ -27,6 +27,7 @@ dependencies = [
     "opentelemetry-exporter-otlp-proto-grpc>=1.0.0,<2",
     "opentelemetry-exporter-otlp-proto-http>=1.0.0,<2",
     "opentelemetry-instrumentation-flask>=0.12b0,<1",
+    "requests>=2.32.3"
 ]
 
 [tool.setuptools.dynamic]