{"id":36547319,"url":"https://github.com/turbot/tailpipe-plugin-nginx","last_synced_at":"2026-01-15T02:42:47.244Z","repository":{"id":277994016,"uuid":"836230233","full_name":"turbot/tailpipe-plugin-nginx","owner":"turbot","description":"Collect nginx logs and query them instantly with SQL! Open source CLI. No DB required.","archived":false,"fork":false,"pushed_at":"2025-12-29T23:35:17.000Z","size":1046,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-01-12T13:26:29.560Z","etag":null,"topics":["duckdb","nginx","nginx-access-log","nginx-log","sql","tailpipe","tailpipe-plugin"],"latest_commit_sha":null,"homepage":"https://hub.tailpipe.io/plugins/turbot/nginx","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/turbot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-07-31T12:19:02.000Z","updated_at":"2025-08-14T06:01:58.000Z","dependencies_parsed_at":"2025-02-17T12:34:45.692Z","dependency_job_id":"118e47d4-800f-40cc-a7d9-0a842cd2efeb","html_url":"https://github.com/turbot/tailpipe-plugin-nginx","commit_stats":null,"previous_names":["turbot/tailpipe-plugin-nginx"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/turbot/tailpipe-plugin-nginx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Ftailpipe-plugin-nginx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Ftailpipe-plugin-nginx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Ftailpipe-plugin-nginx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Ftailpipe-plugin-nginx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/turbot","download_url":"https://codeload.github.com/turbot/tailpipe-plugin-nginx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Ftailpipe-plugin-nginx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28441429,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T00:55:22.719Z","status":"online","status_checked_at":"2026-01-15T02:00:08.019Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["duckdb","nginx","nginx-access-log","nginx-log","sql","tailpipe","tailpipe-plugin"],"created_at":"2026-01-12T06:07:20.637Z","updated_at":"2026-01-15T02:42:47.239Z","avatar_url":"https://github.com/turbot.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nginx Plugin for Tailpipe\n\n[Tailpipe](https://tailpipe.io) is an open-source CLI tool that allows you to collect logs and query them with SQL.\n\n[Nginx](https://nginx.org/) is a popular open-source web server that can also be used as a reverse proxy, load balancer, mail proxy, and HTTP cache.\n\nThe [Nginx Plugin for Tailpipe](https://hub.tailpipe.io/plugins/turbot/nginx) allows you to collect and query Nginx access logs using SQL to track activity, monitor trends, detect anomalies, and more!\n\n- **[Get started →](https://hub.tailpipe.io/plugins/turbot/nginx)**\n- Documentation: [Table definitions \u0026 examples](https://hub.tailpipe.io/plugins/turbot/nginx/tables)\n- Community: [Join #tailpipe on Slack →](https://turbot.com/community/join)\n- Get involved: [Issues](https://github.com/turbot/tailpipe-plugin-nginx/issues)\n\nCollect and query logs:\n![image](docs/images/nginx_access_log_terminal.png)\n\n## Getting Started\n\nInstall Tailpipe from the [downloads](https://tailpipe.io/downloads) page:\n\n```sh\n# MacOS\nbrew install turbot/tap/tailpipe\n```\n\n```sh\n# Linux or Windows (WSL)\nsudo /bin/sh -c \"$(curl -fsSL https://tailpipe.io/install/tailpipe.sh)\"\n```\n\nInstall the plugin:\n\n```sh\ntailpipe plugin install nginx\n```\n\nConfigure your table partition and data source:\n\n```sh\nvi ~/.tailpipe/config/nginx.tpc\n```\n\n```hcl\npartition \"nginx_access_log\" \"my_logs\" {\n  source \"file\" {\n    paths       = [\"/var/log/nginx/access/\"]\n    file_layout = `%{DATA}.log`\n  }\n}\n```\n\n**Note**: By default, the `nginx_access_log` table can collect logs using the combined log format. If your logs use a custom log format, please see [Collect logs with custom log format](https://hub.tailpipe.io/plugins/turbot/nginx/tables/nginx_access_log#collect-logs-with-custom-log-format).\n\nDownload, enrich, and save logs from your source ([examples](https://tailpipe.io/docs/reference/cli/collect)):\n\n```sh\ntailpipe collect nginx_access_log\n```\n\nEnter interactive query mode:\n\n```sh\ntailpipe query\n```\n\nRun a query:\n\n```sql\nselect\n  remote_addr,\n  request_method,\n  request_uri,\n  status,\n  count(*) as request_count\nfrom\n  nginx_access_log\ngroup by\n  remote_addr,\n  request_method,\n  request_uri,\n  status\norder by\n  request_count desc;\n```\n\n```sh\n+---------------+----------------+------------------+--------+---------------+\n| remote_addr   | request_method | request_uri      | status | request_count |\n+---------------+----------------+------------------+--------+---------------+\n| 192.168.1.100 | GET            | /api/users       | 200    | 15243         |\n| 10.0.0.50     | POST           | /api/login       | 401    | 8721          |\n| 172.16.0.25   | GET            | /static/main.css | 304    | 5432          |\n+---------------+----------------+------------------+--------+---------------+\n```\n\n## Developing\n\nPrerequisites:\n\n- [Tailpipe](https://tailpipe.io/downloads)\n- [Golang](https://golang.org/doc/install)\n\nClone:\n\n```sh\ngit clone https://github.com/turbot/tailpipe-plugin-nginx.git\ncd tailpipe-plugin-nginx\n```\n\nAfter making your local changes, build the plugin, which automatically installs the new version to your `~/.tailpipe/plugins` directory:\n\n```sh\nmake\n```\n\nRe-collect your data:\n\n```sh\ntailpipe collect nginx_access_log\n```\n\nTry it!\n\n```sh\ntailpipe query\n\u003e .inspect nginx_access_log\n```\n\n## Open Source \u0026 Contributing\n\nThis repository is published under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) (source code) and [CC BY-NC-ND](https://creativecommons.org/licenses/by-nc-nd/2.0/) (docs) licenses. Please see our [code of conduct](https://github.com/turbot/.github/blob/main/CODE_OF_CONDUCT.md). We look forward to collaborating with you!\n\n[Tailpipe](https://tailpipe.io) is a product produced from this open source software, exclusively by [Turbot HQ, Inc](https://turbot.com). It is distributed under our commercial terms. Others are allowed to make their own distribution of the software, but cannot use any of the Turbot trademarks, cloud services, etc. You can learn more in our [Open Source FAQ](https://turbot.com/open-source).\n\n## Get Involved\n\n**[Join #tailpipe on Slack →](https://turbot.com/community/join)**\n\nWant to help but don't know where to start? Pick up one of the `help wanted` issues:\n\n- [Tailpipe](https://github.com/turbot/tailpipe/labels/help%20wanted)\n- [Nginx Plugin](https://github.com/turbot/tailpipe-plugin-nginx/labels/help%20wanted)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturbot%2Ftailpipe-plugin-nginx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturbot%2Ftailpipe-plugin-nginx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturbot%2Ftailpipe-plugin-nginx/lists"}