add missing overviews, logos and popular items

thesollyz · thesollyz · commit 88a61c00e695 · 2024-10-22T11:55:17.000+03:00
diff --git a/apps/cloudflare-logpush.mdx b/apps/cloudflare-logpush.mdx
@@ -1,10 +1,13 @@
 ---
 title: 'Connect Axiom with Cloudflare Logpush'
 description: "Axiom gives you an all-at-once view of key Cloudflare Logpush metrics and logs, out of the box, with our dynamic Cloudflare Logpush dashboard."
+overview: 'Service for pushing logs to storage services in real-time'
 sidebarTitle: Cloudflare Logpush
 tags:
     ['axiom documentation', 'documentation', 'axiom', 'cloudflare logpush', 'requests', 'edge network', 'route trigger', 'cloudflare']
 logoId: 'cloudflare'
+isPopular: true
+popularityOrder: 6
 ---
 
 Cloudflare Logpush is a feature that allows you to push HTTP request logs and other Cloudflare-generated logs directly to your desired storage, analytics, and monitoring solutions like Axiom. The integration with Axiom aims to provide real-time insights into web traffic, and operational issues, thereby helping to monitor and troubleshoot effectively.
diff --git a/apps/netlify.mdx b/apps/netlify.mdx
@@ -1,6 +1,7 @@
 ---
 title: 'Connect Axiom with Netlify'
 description: 'Integrating Axiom with Netlify to get a comprehensive observability experience for your Netlify projects. This app will give you a better understanding of how your Jamstack apps are performing.'
+overview: 'All-in-one platform for automating modern web projects'
 sidebarTitle: Netlify
 tags:
     ['axiom documentation', 'documentation', 'axiom', 'netlify', log drains', 'jamstack', 'zero config observability']
diff --git a/apps/tailscale.mdx b/apps/tailscale.mdx
@@ -1,6 +1,7 @@
 ---
 title: 'Connect Axiom with Tailscale'
 description: 'This page explains how to integrate Axiom with Tailscale.'
+overview: 'Zero config VPN for building secure networks'
 sidebarTitle: Tailscale
 tags:
     ['axiom documentation', 'documentation', 'axiom', 'guide', 'logs', 'tailscale']
diff --git a/apps/vercel.mdx b/apps/vercel.mdx
@@ -1,6 +1,7 @@
 ---
 title: 'Connect Axiom with Vercel'
 description: 'Easily monitor data from requests, functions, and web vitals in one place to get the deepest observability experience for your Vercel projects.'
+overview: 'Platform for frontend frameworks and static sites'
 sidebarTitle: Vercel
 tags:
   ['axiom documentation', 'documentation', 'axiom', 'vercel', 'request logs', 'function logs', 'web vitals', 'vercel app', 'vercel app']
@@ -268,4 +269,4 @@ For more configuration options, see the [documentation in the next-axiom GitHub
 
 ## Send logs from Vercel preview deployments
 
-To send logs from Vercel preview deployments to Axiom, enable preview deployments for the environment variable `NEXT_PUBLIC_AXIOM_INGEST_ENDPOINT`. For more information, see the [Vercel documentation](https://vercel.com/docs/projects/environment-variables/managing-environment-variables).
+To send logs from Vercel preview deployments to Axiom, enable preview deployments for the environment variable `NEXT_PUBLIC_AXIOM_INGEST_ENDPOINT`. For more information, see the [Vercel documentation](https://vercel.com/docs/projects/environment-variables/managing-environment-variables).
diff --git a/endpoints/loki.mdx b/endpoints/loki.mdx
@@ -5,7 +5,7 @@ overview: 'Horizontally-scalable, multi-tenant log aggregation system'
 sidebarTitle: Loki
 tags:
   ['axiom documentation', 'documentation', 'axiom', 'endpoints', 'http', 'syslog', 'splunk', 'datadog', 'loki', 'honeycomb', 'javascript', 'python']
-logoId: 'loki'
+logoId: 'grafanaLoki'
 ---
 
 import SetUpEndpoint from "/snippets/set-up-endpoint.mdx"
diff --git a/guides/go.mdx b/guides/go.mdx
@@ -3,9 +3,9 @@ title: 'Send data from Go app to Axiom'
 description: 'This page explains how to send data from a Go app to Axiom.'
 overview: 'Open-source programming language designed for simplicity and efficiency'
 sidebarTitle: Golang
-url: "https://github.com/axiomhq/axiom-go"
+github: "https://github.com/axiomhq/axiom-go"
 tags: ['go', 'golang']
-logoId: 'go'
+logoId: 'golang'
 enlargeLogo: true
 ---
 
@@ -96,4 +96,3 @@ For more examples, see the [examples in GitHub](https://github.com/axiomhq/axiom
 ## Adapters
 
 To use a logging package, see the [adapters in GitHub](https://github.com/axiomhq/axiom-go/tree/main/adapters).
-
diff --git a/guides/javascript.mdx b/guides/javascript.mdx
@@ -3,9 +3,11 @@ title: 'Send data from JavaScript app to Axiom'
 description: 'This page explains how to send data from a JavaScript app to Axiom.'
 overview: 'High-level, interpreted programming language for web development'
 sidebarTitle: JavaScript
-url: "https://github.com/axiomhq/axiom-js"
+github: "https://github.com/axiomhq/axiom-js"
 tags: ['js', 'javascript', 'node', 'typescript', 'ts', 'node.js']
 logoId: 'javascript'
+isPopular: true
+popularityOrder: 8
 ---
 
 To send data from a JavaScript app to Axiom, use the Axiom JavaScript SDK.
@@ -99,4 +101,3 @@ While the Axiom JavaScript client works on both the backend and the browsers, Ax
 
 - [Pino](/guides/pino)
 - [Winston](/guides/winston)
-
diff --git a/guides/python.mdx b/guides/python.mdx
@@ -3,7 +3,7 @@ title: 'Send data from Python app to Axiom'
 description: 'This page explains how to send data from a Python app to Axiom.'
 overview: 'Interpreted, high-level, general-purpose programming language'
 sidebarTitle: Python
-url: "https://github.com/axiomhq/axiom-py"
+github: "https://github.com/axiomhq/axiom-py"
 tags: ['py', 'python']
 logoId: 'python'
 ---
@@ -106,4 +106,3 @@ def setup_logger():
 ```
 
 For a full example, see [GitHub](https://github.com/axiomhq/axiom-py/tree/main/examples/structlog_example.py).
-
diff --git a/guides/rust.mdx b/guides/rust.mdx
@@ -3,7 +3,7 @@ title: 'Send data from Rust app to Axiom'
 description: 'This page explains how to send data from a Rust app to Axiom.'
 overview: 'Systems programming language focused on safety and performance'
 sidebarTitle: Rust
-url: "https://github.com/axiomhq/axiom-rs"
+github: "https://github.com/axiomhq/axiom-rs"
 tags: ['rs', 'rust']
 logoId: 'rust'
 darkLogoId: 'rustDark'
diff --git a/ingest-options.json b/ingest-options.json
diff --git a/restapi/introduction.mdx b/restapi/introduction.mdx
@@ -7,6 +7,8 @@ tags:
     ['axiom documentation', 'documentation', 'axiom', 'axiom api', 'rest api', 'rest', 'content type', 'datasets', 'authentication', 'string', 'boolean', 'integer', 'float', 'map', 'list']
 logoId: 'http'
 enlargeLogo: true
+isPopular: true
+popularityOrder: 1
 ---
 
 Axiom understands your resources and provides an API to ingest structured data logs, handle queries, and manage your deployments. This REST-style API uses JSON for serialization and gives you complete control over the entire Axiom platform.
diff --git a/scripts/generate-ingest-options.mjs b/scripts/generate-ingest-options.mjs
@@ -9,7 +9,7 @@ const generateList = async () => {
   // unfortunately the integration group has other stuff than sending data
   // so we need to filter it out.
   groups.push({
-    group: "Apps & Integraitons",
+    group: "Apps & Integrations",
     pages: [
       "apps/cloudflare-logpush",
       "apps/netlify",
@@ -61,6 +61,7 @@ const parsePageInfo = async (path, group) => {
 
 const main = async () => {
   const ingestOptions = await generateList();
+  console.log("------");
   console.log(
     `found ${ingestOptions.length} ingest options categorized as follows:`,
   );
@@ -77,6 +78,15 @@ const main = async () => {
     console.log(`\t${key}: ${stats[key]} options`);
   }
 
+  console.log("------");
+  // print popular items
+  const popularItems = ingestOptions.filter((opt) => opt.isPopular);
+  console.log(`popular items (${popularItems.length}):`);
+  popularItems
+    .sort((a, b) => a.popularityOrder - b.popularityOrder)
+    .map((opt) => {
+      console.log(`\t${opt.popularityOrder}. ${opt.name}`);
+    });
   console.log("------");
   console.log("writing result to file...");
   await writeFile(
diff --git a/send-data/aws-lambda.mdx b/send-data/aws-lambda.mdx
@@ -5,6 +5,8 @@ overview: 'Serverless compute service for running code without servers'
 sidebarTitle: AWS Lambda
 tags: ['aws', 'axiom documentation', 'documentation', 'axiom', 'aws lambda', 'axiom lambda extension', 'cloudwatch subscription filters', 'terraform', 'lambda function layer', 'environment variables']
 logoId: 'awsLambda'
+isPopular: true
+popularityOrder: 5
 ---
 
 import AwsDisclaimer from "/snippets/aws-disclaimer.mdx"
diff --git a/send-data/cloudwatch.mdx b/send-data/cloudwatch.mdx
@@ -5,6 +5,8 @@ overview: 'Monitoring and observability service for AWS resources'
 sidebarTitle: Amazon CloudWatch
 tags: ['aws', 'axiom documentation', 'documentation', 'axiom', 'Amazon cloudwatch', 'aws s3', 'aws lambda', 'cloudwatch log groups']
 logoId: 'cloudwatch'
+isPopular: true
+popularityOrder: 4
 ---
 
 import Prerequisites from "/snippets/standard-prerequisites.mdx"
diff --git a/send-data/cribl.mdx b/send-data/cribl.mdx
@@ -5,6 +5,8 @@ overview: 'Data stream processing tool for log data collection and routing'
 sidebarTitle: Cribl
 tags: ['cribl', 'axiom documentation', 'documentation', 'axiom', 'cribl logstream', 'log forwarding', 'http destination', 'syslog destination', 'log integration']
 logoId: 'cribl'
+isPopular: true
+popularityOrder: 10
 ---
 
 Cribl is a data processing framework often used with machine data. It allows you to parse, reduce, transform, and route data to and from various systems in your infrastructure.
diff --git a/send-data/elastic-beats.mdx b/send-data/elastic-beats.mdx
@@ -6,6 +6,8 @@ sidebarTitle: Elastic Beats
 tags:
   ['elasticsearch', 'axiom documentation', 'documentation', 'axiom', 'elastic beats', 'logs', 'metrics']
 logoId: 'elastic'
+isPopular: true
+popularityOrder: 7
 ---
 
 [Elastic Beats](https://www.elastic.co/beats/) serves as a lightweight platform for data shippers that transfer information from the source to Axiom and other tools based on the configuration. Before shipping data, it collects metrics and logs from different sources, which later are deployed to your Axiom deployments.
diff --git a/send-data/fluent-bit.mdx b/send-data/fluent-bit.mdx
@@ -6,6 +6,8 @@ sidebarTitle: Fluent Bit
 tags:
     ['fluentd', 'axiom documentation', 'documentation', 'axiom', 'guide', 'logs', 'fluent bit', 'metrics']
 logoId: 'fluentbit'
+isPopular: true
+popularityOrder: 11
 ---
 
 ## Fluent Bit
diff --git a/send-data/fluentd.mdx b/send-data/fluentd.mdx
@@ -6,6 +6,8 @@ sidebarTitle: Fluentd
 tags:
   ['fluentd', 'axiom documentation', 'documentation', 'axiom', 'guide', 'logs', 'metrics', 'http output plugin', 'opensearch output plugin']
 logoId: 'fluentd'
+isPopular: true
+popularityOrder: 12
 ---
 
 ## Fluentd
diff --git a/send-data/loki-multiplexer.mdx b/send-data/loki-multiplexer.mdx
@@ -5,7 +5,7 @@ overview: 'Gateway for connecting to Axiom via Loki endpoint'
 sidebarTitle: Loki Multiplexer
 tags:
   ['loki', 'axiom documentation', 'documentation', 'axiom', 'guide', 'logs', 'loki logs', 'loki multiplexer', 'http api']
-logoId: 'loki'
+logoId: 'grafanaLoki'
 ---
 
 Loki by Prometheus is a multi-tenant log aggregation system that’s highly scalable and capable of indexing metadata about your logs.
diff --git a/send-data/nextjs.mdx b/send-data/nextjs.mdx
@@ -5,7 +5,9 @@ overview: 'React framework for production-grade applications'
 sidebarTitle: Next.js
 tags:
   ['js', 'axiom documentation', 'documentation', 'axiom', 'guide', 'logs', 'nextjs', 'next.js', 'next', 'next-axiom', 'javascript']
-logoId: 'nextjs'
+isPopular: true
+popularityOrder: 9
+logoId: 'nextJs'
 ---
 
 Next.js is a popular open-source JavaScript framework built on top of React, developed by Vercel. It’s used by a wide range of companies and organizations, from startups to large enterprises, due to its performance benefits and developer-friendly features.
diff --git a/send-data/opentelemetry.mdx b/send-data/opentelemetry.mdx
@@ -6,6 +6,8 @@ sidebarTitle: OpenTelemetry
 tags:
   ['otel', 'axiom documentation', 'documentation', 'axiom', 'guide', 'opentelemetry', 'otlp', 'traces', 'logs', 'http exporter', 'http', 'grpc']
 logoId: 'openTelemetry'
+isPopular: true
+popularityOrder: 2
 ---
 
 OpenTelemetry (OTel) is a set of APIs, libraries, and agents to capture distributed traces and metrics from your app. It’s a Cloud Native Computing Foundation (CNCF) project that was started to create a unified solution for service and app performance monitoring.
diff --git a/send-data/vector.mdx b/send-data/vector.mdx
@@ -6,6 +6,8 @@ sidebarTitle: Vector
 tags:
   ['vector', 'axiom documentation', 'documentation', 'axiom', 'guide', 'vector sink', 'docker logs', 'kubernetes logs', 'aws s3 logs', 'kafka logs']
 logoId: 'vector'
+isPopular: true
+popularityOrder: 3
 ---
 
 <Frame caption="Vector">
