{"id":19645288,"url":"https://github.com/yandex-cloud/fluent-bit-plugin-yandex","last_synced_at":"2025-04-28T14:32:38.442Z","repository":{"id":40369597,"uuid":"403930026","full_name":"yandex-cloud/fluent-bit-plugin-yandex","owner":"yandex-cloud","description":"Yandex Cloud Logging output for Fluent Bit","archived":false,"fork":false,"pushed_at":"2024-11-01T14:38:13.000Z","size":93,"stargazers_count":21,"open_issues_count":2,"forks_count":1,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-05T09:11:12.174Z","etag":null,"topics":["fluent-bit","logging","yandex"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yandex-cloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-07T10:06:44.000Z","updated_at":"2025-03-12T09:12:07.000Z","dependencies_parsed_at":"2024-04-15T19:43:38.617Z","dependency_job_id":"dad7bb7c-62f9-4e47-8def-0b8a40788c42","html_url":"https://github.com/yandex-cloud/fluent-bit-plugin-yandex","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex-cloud%2Ffluent-bit-plugin-yandex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex-cloud%2Ffluent-bit-plugin-yandex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex-cloud%2Ffluent-bit-plugin-yandex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yandex-cloud%2Ffluent-bit-plugin-yandex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yandex-cloud","download_url":"https://codeload.github.com/yandex-cloud/fluent-bit-plugin-yandex/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251330480,"owners_count":21572291,"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":["fluent-bit","logging","yandex"],"created_at":"2024-11-11T14:33:12.497Z","updated_at":"2025-04-28T14:32:33.383Z","avatar_url":"https://github.com/yandex-cloud.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fluent Bit plugin for Yandex Cloud Logging\n\n[Fluent Bit](https://fluentbit.io)\n[output](https://docs.fluentbit.io/manual/concepts/data-pipeline/output)\nfor\n[Yandex Cloud Logging](https://cloud.yandex.ru/docs/logging).\n\n## Configuration parameters\n\nAll configuration parameters can be templated via [metadata service](#metadata). You can define templated value as follows: `{{key:default}}` or `{{key}}` (in this case `\"\"` used as default value). All strings matched this template will be replaced by metadata values. In `default_payload` parameter you also can use this template as a JSON value (without quotes), so that JSON struct or array will be included in default payload.\n\n| Key               | Description | \n|:------------------|:---|\n| `group_id`        | (_optional_) [Log group](https://cloud.yandex.ru/docs/logging/concepts/log-group) ID. Has higher priority than `folder_id`. |\n| `folder_id`       | (_optional_) Folder ID. Has lower priority than `group_id`. Can be auto-detected via [metadata service](#metadata) if `group_id` and `folder_id` are not set. |\n| `resource_type`   | (_optional_) Resource type of log entries. Can be templated via entry payload as follows: `{entry/json/path}`. | \n| `resource_id`     | (_optional_) Resource id of log entries. Can be templated via entry payload as follows: `{entry/json/path}`. | \n| `stream_name`     | (_optional_) Resource id of log entries. Can be templated via entry payload as follows: `{entry/json/path}`. | \n| `message_tag_key` | Key of the field to be assigned to the message tag. By default, will be skipped. | \n| `message_key`     | Key of the field, which will go to `message` attribute of LogEntry. | \n| `level_key`       | Key of the field, which contains log level, optional. |\n| `default_level`   | (_optional_) Default level for messages, i.e., `INFO`. |\n| `default_payload` | (_optional_) String with default JSON payload for entries (will be merged together with custom entry payload). |\n| `endpoint`        | (_optional_) API endpoint. Сan be set custom endpoint, for example, a [regional one](https://yandex.cloud/ru/docs/overview/concepts/region). Default value: `api.cloud.yandex.net:443`. |\n| `authorization`   | See [Authorization](#authorization) section below. |\n\n### Metadata\n\n[Metadata service documentation](https://cloud.yandex.com/en/docs/compute/concepts/vm-metadata).\n\nMetadata url can be configured through environment variable `YC_METADATA_URL`. By default it's `http://169.254.169.254`.\n\n### Authorization\n\nConfiguration parameter `authorization` may have one of the following values:\n\n| Value | Description |\n|:---|:---|\n|`instance-service-account` | run on behalf of instance service account |\n| `iam-token` | environment variable `YC_TOKEN` \u003cbr\u003e must contain a valid IAM token for authorization |\n| `iam-key-file:/path/key.json` | use IAM key for authorization |\n\nTo create the key file, use [yc cli](https://cloud.yandex.ru/docs/cli/cli-ref/managed-services/iam/key/create).\nExample:\n```bash\n  yc iam key create --service-account-name my-service-account --output key.json\n```\n\n### Configuration example\n\n```\n[OUTPUT]\n    Name            yc-logging\n    Match           *\n    group_id        abc_{{group-id}}\n    resource_type   {{resource}}_{resource/type}\n    resource_id     {resource/id}\n    message_key     text\n    level_key       severity\n    default_level   WARN\n    default_payload {\"num\":5, \"str\": \"string\", \"bool\": true, \"host\":\"{{instance/hostname}}\", \"not-found\":\"{{not/found:default}}\", \"struct\": {{instance/disks/0}}, \"array\": {{instance/disks}} }\n    authorization   instance-service-account\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyandex-cloud%2Ffluent-bit-plugin-yandex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyandex-cloud%2Ffluent-bit-plugin-yandex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyandex-cloud%2Ffluent-bit-plugin-yandex/lists"}