Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/russorat/logstash-output-salesforce
This logstash output provides an easy way to create and update Salesforce sObjects using the api.
https://github.com/russorat/logstash-output-salesforce
Last synced: about 2 months ago
JSON representation
This logstash output provides an easy way to create and update Salesforce sObjects using the api.
- Host: GitHub
- URL: https://github.com/russorat/logstash-output-salesforce
- Owner: russorat
- License: other
- Created: 2014-12-12T19:37:43.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2021-10-13T16:30:45.000Z (over 3 years ago)
- Last Synced: 2024-10-14T11:27:45.793Z (3 months ago)
- Language: Ruby
- Size: 12.7 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Logstash Plugin
This is a plugin for [Logstash](https://github.com/elasticsearch/logstash).
It is fully free and fully open source. The license is Apache 2.0, meaning you are pretty much free to use it however you want in whatever way.
## Documentation
logstash-output-salesforce
==========================
This logstash output provides an easy way to create and update Salesforce sObjects using the api.
A sample Logstash config might look something like this:
```
salesforce {
client_id => ''
client_secret => ''
username => '[email protected]'
password => 'secret-password'
security_token => ''
sfdc_object_name => 'Contact'
event_to_sfdc_keys_mapping => {
"[email]" => "Email"
}
event_to_sfdc_mapping => {
"[first_name]" => "First_Name"
"[last_name]" => "Last_Name"
}
raw_values_to_sfdc_mapping => {
"1" => "Was_found__c"
}
increment_fields => [ "times_found" ]
should_create_new_records => true
}
```
## Need Help?
Need help? Try #logstash on freenode IRC or the [email protected] mailing list. Or file an issue.
## Developing
### 1. Plugin Developement and Testing
#### Code
- To get started, you'll need JRuby with the Bundler gem installed.
- Create a new plugin or clone and existing from the GitHub [logstash-plugins](https://github.com/logstash-plugins) organization. We also provide [example plugins](https://github.com/logstash-plugins?query=example).
- Install dependencies
```sh
bundle install
```
#### Test
- Update your dependencies
```sh
bundle install
```
- Run tests
```sh
bundle exec rspec
```
#### 2.2 Run in an installed Logstash
You can use the same **2.1** method to run your plugin in an installed Logstash by editing its `Gemfile` and pointing the `:path` to your local plugin development directory or you can build the gem and install it using:
- Build your plugin gem
```sh
gem build logstash-output-salesforce.gemspec
```
- Install the plugin from the Logstash home
```sh
bin/plugin install /your/local/plugin/logstash-output-salesforce.gem
```
- Start Logstash and proceed to test the plugin
## Contributing
All contributions are welcome: ideas, patches, documentation, bug reports, complaints, and even something you drew up on a napkin.
Programming is not a required skill. Whatever you've seen about open source and maintainers or community members saying "send patches or die" - you will not see that here.
It is more important to the community that you are able to contribute.
For more information about contributing, see the [CONTRIBUTING](https://github.com/elasticsearch/logstash/blob/master/CONTRIBUTING.md) file.