Repository for the Fili web service.
Monitoring and Operations
There is a list of Key Performance Indicators (KPIs) for the web service. It doesn't go into detail about what each of the KPIs mean, but it gives a rough overview of why they matter.
Useful Links
How to configure properties locally
Configuration is resolved in the following order
- Environment variables
- Java properties
userConfig.properties
(By convention this should only be used for a controlling a specific non-standard environment, such as a development box)testApplicationConfig.properties
(By convention this should only be used for test runner overrides)applicationConfig.properties
(Every application should provide one of these)- Additional
moduleConfig.properties
found on the class path.
The .gitignore file includes a rule to ignore userConfig.properties
this by default to help prevent checking it in accidentally.
How do I enable Redis?
To enable Redis on local machines:
- set the
test__dimension_backend
property toredis
- set the
test__key_value_store_tests
property toredis
in src/test/resources/userConfig.properties
or in an environment variable.
Miscellaneous Information
Maven doesn't run on my Mac. Help!
Maven picks up the wrong version of Java. If you run mvn --version
you'll see that it probably says that the Java version isn't 1.8 but is 1.7, or some even earlier version.
To remedy this, you need to make sure you have the JAVA_HOME
environment variable exported. To export this variable, put the following line in your ~/.bash_profile
file:
export JAVA_HOME=`/usr/libexec/java_home -v 1.8`
Additionally, to work with yahoo.bintray.com/maven, you need to copy the settings.xml file into `~/.m2/
The easiest way to run tests on a Mac is to use in memory dimension backend and key value store:
mvn -Dtest__dimension_backend=memory -Dtest__key_value_store_tests=memory clean test
I want to contribute to Fili. Are there any code style guidelines I should follow?
For the moment, we have distilled the most important code style conventions with respect to Fili's code as IntelliJ settings.
If you are using IntelliJ, you may import these code style settings by importing: Fili-Project.xml
They will appear as a new Scheme named Bard-Project under your Editor → Code Style section.
Alternatively, you might check the xml file that is included in the jar and map its settings to your development environment.
We have also included a large amount of checkstyle rules, that should catch 98% of the code style guidelines. The Google Java style guide is very close to our style.