{"id":19010411,"url":"https://github.com/instacart/socketlogger.swift","last_synced_at":"2025-09-06T22:35:02.176Z","repository":{"id":66031620,"uuid":"87509266","full_name":"instacart/SocketLogger.swift","owner":"instacart","description":"Lightweight, flexible logging utility compatible with any socket-based syslog service.","archived":false,"fork":false,"pushed_at":"2019-04-18T23:35:32.000Z","size":52,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-04-22T23:36:53.586Z","etag":null,"topics":["ios","logging","socket","swift","syslog"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/instacart.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-04-07T05:46:58.000Z","updated_at":"2022-06-29T20:18:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"6dfb23b2-2b2d-4fa7-9cb3-8021a009ec32","html_url":"https://github.com/instacart/SocketLogger.swift","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/instacart/SocketLogger.swift","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instacart%2FSocketLogger.swift","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instacart%2FSocketLogger.swift/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instacart%2FSocketLogger.swift/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instacart%2FSocketLogger.swift/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/instacart","download_url":"https://codeload.github.com/instacart/SocketLogger.swift/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instacart%2FSocketLogger.swift/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273973765,"owners_count":25200575,"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","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"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":["ios","logging","socket","swift","syslog"],"created_at":"2024-11-08T19:11:07.028Z","updated_at":"2025-09-06T22:35:02.150Z","avatar_url":"https://github.com/instacart.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SocketLogger\n\nSocketLogger is a logging µlib compatible with any socket-based syslog\nservice. Allows flexibility to choose between various logging providers while\nintegrating with any logging framework of your choice (e.g.\n[SwiftyBeaver](https://github.com/SwiftyBeaver/SwiftyBeaver),\n[Willow](https://github.com/Nike-Inc/Willow),\n[XCGLogger](https://github.com/DaveWoodCom/XCGLogger)).\n\n## Requirements\n\nSocketLogger is compatible with iOS 8+, macOS 10.10 and tvOS 9.\nRequires Swift 4.\n\n## Installation\n\n### [Carthage](https://github.com/Carthage/Carthage)\n\nAdd this to your `Cartfile`:\n\n```\ngithub \"instacart/SocketLogger.swift\"\n```\n\nThen run:\n\n```\n$ carthage update\n```\n\n## Usage\n\n### Swift\n\nInitialize the logger:\n```swift\nimport SocketLogger\nlet logger = SocketLogger(host: \"myloggingprovider.io\", port: 0356, token: \"[token]\")\n```\n\nLog a message (or integrate with a logging framework of your choice):\n```swift\nlogger.log(details: .init(hostname: \"mymachine.example.com\", application: \"SocketLogger\"),\n           message: \"A socket is a generalized interprocess communication channel.\")\n```\n\n## Integration\n\nWe have included a handful of\n[examples](https://github.com/instacart/SocketLogger.swift/tree/master/Examples)\nfor using SocketLogger with popular logging frameworks in this repo.\n\n### Carthage\n\nSince Carthage has no notion of subspecs, these must be copied manually:\n\n- Run `carthage checkout`.\n- Drag `Carthage/Checkouts/SocketLogger.swift/Examples/{library}` to your\n  project. Make sure the \"Copy items if needed\" toggle is turned off.\n- Integrate according to instructions with your logging framework.\n\n## Providers\n\nSocketLogger currently supports:\n\n- [Papertrail](https://papertrailapp.com/)\n- [Loggly](https://www.loggly.com/)\n- [LogDNA](https://logdna.com/)\n\nDon't see yours listed? \n[Add it](https://github.com/instacart/SocketLogger.swift/blob/607184c/Sources/SocketLogger.swift#L88)\n[today](https://github.com/instacart/SocketLogger.swift/pulls/)!\n\n## License\n\n```\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstacart%2Fsocketlogger.swift","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finstacart%2Fsocketlogger.swift","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstacart%2Fsocketlogger.swift/lists"}