cel,httpjson: advise to use CEL over HTTPJSON for new projects (#9018)

Author: efd6

packages/cel/changelog.yml

@@ -1,3 +1,8 @@
+- version: "1.8.0"
+ changes:
+ - description: Clarify naming of input.
+ type: enhancement
+ link: https://github.com/elastic/integrations/pull/9018
 - version: "1.7.1"
  changes:
  - description: Changed owners

packages/cel/docs/README.md

@@ -1,8 +1,8 @@
 # CEL Custom API input integration
 
-The CEL custom API input integration is used to ingest data from custom HTTP and local file-system APIs that do not currently have an existing integration.
+The Common Expression Language (CEL) custom API input integration is used to ingest data from custom HTTP and local file-system APIs that do not currently have an existing integration.
 
-The input itself supports making both HTTP requests and file-system read operations, and keeping running and persistent state on information from the last collected events. The input performs [Common Expression Language](https://opensource.google.com/projects/cel) with a [set of standard extensions](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-input-cel.html#_cel_extension_libraries) to both obtain input data from the API and then process the data into events that are published to Elasticsearch.
+The input itself supports making both HTTP requests and file-system read operations, and keeping running and persistent state on information from the last collected events. The input performs [Common Expression Language](https://opensource.google.com/projects/cel) expression evaluation with a [set of standard extensions](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-input-cel.html#_cel_extension_libraries) to both obtain input data from the API and then process the data into events that are published to Elasticsearch.
 
 ## Configuration
 

packages/cel/manifest.yml

@@ -1,9 +1,9 @@
 format_version: "3.0.0"
 name: cel
-title: CEL Custom API
+title: Custom API using Common Expression Language
 description: Collect custom events from an API with Elastic agent
 type: input
-version: "1.7.1"
+version: "1.8.0"
 categories:
  - custom
 conditions:

packages/httpjson/_dev/build/docs/README.md

@@ -4,6 +4,8 @@ The custom API input integration is used to ingest data from custom RESTful API'
 
 The input itself supports sending both GET and POST requests, transform requests and responses during runtime, paginate and keep a running state on information from the last collected events.
 
+If you are starting development of a new custom HTTP API input, we recommend that you use the [Common Expression Language input](../cel/overview) which provides greater flexibility and an improved developer experience.
+
 ## Configuration
 
 The extensive documentation for the input are currently available {{ url "filebeat-input-httpjson" "here" }}.

packages/httpjson/changelog.yml

@@ -1,3 +1,8 @@
+- version: "1.19.0"
+ changes:
+ - description: Advise new projects to use CEL.
+ type: enhancement
+ link: https://github.com/elastic/integrations/pull/9018
 - version: "1.18.1"
  changes:
  - description: Changed owners

packages/httpjson/docs/README.md

@@ -4,6 +4,8 @@ The custom API input integration is used to ingest data from custom RESTful API'
 
 The input itself supports sending both GET and POST requests, transform requests and responses during runtime, paginate and keep a running state on information from the last collected events.
 
+If you are starting development of a new custom HTTP API input, we recommend that you use the [Common Expression Language input](../cel/overview) which provides greater flexibility and an improved developer experience.
+
 ## Configuration
 
 The extensive documentation for the input are currently available [here](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-input-httpjson.html).

packages/httpjson/manifest.yml

@@ -3,7 +3,7 @@ name: httpjson
 title: Custom API
 description: Collect custom events from an API endpoint with Elastic agent
 type: integration
-version: "1.18.1"
+version: "1.19.0"
 conditions:
  kibana:
  version: "^8.7.1"