{"id":26009987,"url":"https://github.com/byu-oit/terraform-aws-humio-logger","last_synced_at":"2026-04-19T12:31:33.688Z","repository":{"id":38817472,"uuid":"386644228","full_name":"byu-oit/terraform-aws-humio-logger","owner":"byu-oit","description":"Infrastructure to watch a CloudWatch log group and forward its logs to Humio.","archived":false,"fork":false,"pushed_at":"2023-09-01T10:46:28.000Z","size":16364,"stargazers_count":0,"open_issues_count":9,"forks_count":0,"subscribers_count":23,"default_branch":"main","last_synced_at":"2024-04-14T06:10:00.958Z","etag":null,"topics":["terraform-module"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/byu-oit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-16T13:19:53.000Z","updated_at":"2024-04-14T06:10:00.958Z","dependencies_parsed_at":"2023-02-18T10:15:55.913Z","dependency_job_id":null,"html_url":"https://github.com/byu-oit/terraform-aws-humio-logger","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byu-oit%2Fterraform-aws-humio-logger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byu-oit%2Fterraform-aws-humio-logger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byu-oit%2Fterraform-aws-humio-logger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byu-oit%2Fterraform-aws-humio-logger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/byu-oit","download_url":"https://codeload.github.com/byu-oit/terraform-aws-humio-logger/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242112782,"owners_count":20073669,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["terraform-module"],"created_at":"2025-03-05T22:26:47.265Z","updated_at":"2026-04-19T12:31:33.678Z","avatar_url":"https://github.com/byu-oit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Latest GitHub Release](https://img.shields.io/github/v/release/byu-oit/terraform-aws-humio-logger?sort=semver)\n\n# Terraform AWS Humio Logger\n\nInfrastructure to watch a CloudWatch log groups and forward their logs to a Humio log repository.\n\n#### [New to Terraform Modules at BYU?](https://devops.byu.edu/terraform/index.html)\n\n## Usage\n\nBefore including this module in your project, you should create a new humio log repository and generate an ingest token\nto pass into this module.\nRead the [Ingest Tokens documentation](https://library.humio.com/cloud/docs/ingesting-data/ingest-tokens/) for more\ninformation.\n\n\u003e The [ACS Info Terraform Module](https://github.com/byu-oit/terraform-aws-acs-info) provides the Humio dev and prd\n\u003e endpoints for convenience. It is recommended that you only use the prd endpoint (even for deployments of dev\n\u003e resources) because it is a stable endpoint.\n\n### Example with Fargate Module\n\n```hcl\nmodule \"acs\" {\n source = \"github.com/byu-oit/terraform-aws-acs-info?ref=v3.5.0\"\n vpc_vpn_to_campus = true\n}\n\ndata \"aws_cloudwatch_log_group\" \"my_fargate_api\" {\n # Ensures the cloudwatch log group is there\n depends_on = [module.my_fargate_api]\n name = \"fargate/${local.name}-${var.env}\"\n}\n\nmodule \"humio_logger\" {\n source = \"github.com/byu-oit/terraform-aws-humio-logger?ref=v3.0.6\"\n app_name = \"humio-logger-ci-dev\"\n humio_protocol = \"HTTP\"\n # Only the http protocol is supported for the ACS-provided Humio Endpoints (as of May 26, 2022)\n humio_host = \"${module.acs.humio_prd_endpoint}:8080\" # Default is port 80\n humio_ingest_token = var.humio_dev_token # Must provide this for each humio log repo\n humio_lambda_role_permissions_boundary = module.acs.role_permissions_boundary.arn\n vpc_id = module.acs.vpc.id\n subnet_ids = module.acs.private_subnet_ids\n logs_subscriptions = [\n data.aws_cloudwatch_log_group.my_fargate_api.name\n ]\n}\n```\n\n## Requirements\n\n* Terraform version 0.14 or greater\n* AWS provider version 4.15 or greater\n* BYU-ACS version 3.5.0 or greater\n\n## Inputs\n\n| Name | Type | Description | Default |\n|----------------------------------------|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|\n| app_name | string | The application name to include in the name of resources created. | |\n| humio_protocol | string | The transport protocol used for delivering log/metric events to Humio. HTTPS is default and recommended. | HTTPS |\n| humio_host | string | The host to ship Humio log/metric events to. | cloud.humio.com |\n| humio_ingest_token (sensitive) | string | The value of the ingest token for the repository from your Humio account to ship log/metric events to. | \"\" |\n| humio_lambda_log_retention | number | Number of days to retain CloudWatch logs from the Humio Lambda functions. | 1 |\n| humio_lambda_role_permissions_boundary | string | The ARN of the role permissions boundary to attach to the Humio Lambda role. | \"\" |\n| logs_subscriptions | list(string) | Subscribes the log ingester lambda to each log group listed. | [] |\n| metric_conf | string | A stringified metric configuration to pass into the [CloudWatch GetMetricData command](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html). This configuration will be uploaded to the s3 bucket. An example configuration is located in the `examples/static` directory of this repository. | \"\" |\n| metric_statistics_conf | string | A stringified list of metric statistics configurations that will each be passed into the [CloudWatch GetMetricStatistics command](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html). This configuration will be uploaded to the s3 bucket. An example configuration is located in the `examples/static` directory of this repository. | \"\" |\n| log_level | string | The log level for the Humio lambdas. | INFO |\n| s3_bucket | string | The name of the S3 bucket where your lambda ingester code is located. If none is specified, a bucket will be created with the name `\u003capp_name\u003e-humio-logger` | \"\" |\n| vpc_id | string | Use a VPC for the lambda ingester functions. Pass in a VPC ID to deploy the ingester lambdas in the VPC. | \"\" |\n| security_group_ids | list(string) | A list of security group ids for the VPC configuration regarding the ingester lambda functions. Only required if VPC is enabled. | [] |\n| subnet_ids | list(string) | A list of subnet ids used by the VPC configuration that the ingester lambda functions will be deployed into. Only required if VPC is enabled. | [] |\n\n## Outputs\n\nIn addition to all non-sensitive arguments above, the following attributes are exported:\n\n\u003c!-- TODO --\u003e\n\n## Deployment\n\nPush changes to the main branch and create a new release of the humio logger\nfollowing [the semantic versioning specification](https://semver.org).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyu-oit%2Fterraform-aws-humio-logger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbyu-oit%2Fterraform-aws-humio-logger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyu-oit%2Fterraform-aws-humio-logger/lists"}